POST
/
forms
/
{formId}
/
submissions
Create submissions
curl --request POST \
  --url https://api.fillout.com/v1/api/forms/{formId}/submissions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "submissions": [
    {
      "questions": [
        {
          "id": "<string>",
          "value": "<any>"
        }
      ],
      "urlParameters": [
        {
          "id": "<string>",
          "name": "<string>",
          "value": "<string>"
        }
      ],
      "submissionTime": "2023-11-07T05:31:56Z",
      "lastUpdatedAt": "2023-11-07T05:31:56Z",
      "scheduling": [
        {
          "id": "<string>",
          "value": {
            "fullName": "<string>",
            "email": "jsmith@example.com",
            "eventStartTime": "2023-11-07T05:31:56Z",
            "eventEndTime": "2023-11-07T05:31:56Z",
            "timezone": "<string>",
            "userId": 123,
            "scheduledUserEmail": "jsmith@example.com",
            "eventId": "<string>",
            "eventUrl": "<string>",
            "rescheduleOrCancelUrl": "<string>",
            "meetingNotes": "<string>"
          }
        }
      ],
      "payments": [
        {
          "id": "<string>",
          "value": {
            "paymentId": "<string>",
            "stripeCustomerId": "<string>",
            "stripeCustomerUrl": "<string>",
            "stripePaymentUrl": "<string>",
            "totalAmount": 123,
            "currency": "<string>",
            "email": "jsmith@example.com",
            "status": "<string>",
            "stripeSubscriptionId": "<string>"
          }
        }
      ],
      "login": {
        "email": "jsmith@example.com"
      }
    }
  ]
}'
{
  "submissions": [
    {
      "submissionId": "<string>",
      "submissionTime": "2023-11-07T05:31:56Z",
      "lastUpdatedAt": "2023-11-07T05:31:56Z",
      "questions": [
        {
          "id": "<string>",
          "name": "<string>",
          "type": "<string>",
          "value": "<any>"
        }
      ],
      "calculations": [
        {
          "id": "<string>",
          "name": "<string>",
          "type": "number",
          "value": "<string>"
        }
      ],
      "urlParameters": [
        {
          "id": "<string>",
          "name": "<string>",
          "value": "<string>"
        }
      ],
      "scheduling": [
        {
          "id": "<string>",
          "name": "<string>",
          "value": {
            "fullName": "<string>",
            "email": "jsmith@example.com",
            "timezone": "<string>",
            "eventStartTime": "2023-11-07T05:31:56Z",
            "eventEndTime": "2023-11-07T05:31:56Z",
            "eventId": "<string>",
            "eventUrl": "<string>",
            "rescheduleOrCancelUrl": "<string>",
            "userId": 123,
            "scheduledUserEmail": "jsmith@example.com",
            "meetingNotes": "<string>"
          }
        }
      ],
      "payments": [
        {
          "id": "<string>",
          "name": "<string>",
          "value": {
            "paymentId": "<string>",
            "stripeCustomerId": "<string>",
            "stripeCustomerUrl": "<string>",
            "stripePaymentUrl": "<string>",
            "totalAmount": 123,
            "currency": "<string>",
            "email": "jsmith@example.com",
            "discountCode": "<string>",
            "status": "<string>",
            "stripeSubscriptionId": "<string>"
          }
        }
      ],
      "quiz": {
        "score": 123,
        "maxScore": 123
      },
      "login": {
        "email": "jsmith@example.com"
      }
    }
  ]
}
Once imported, your submissions will be visible in the “Results” tab of the form editor.

Authorizations

Authorization
string
header
required

Enter your Fillout API key. Format: Bearer <api_key>

Path Parameters

formId
string
required

The public identifier of the form

Body

application/json

Response

200 - application/json

Created submissions

The response is of type object.