POST
/
v1
/
api
/
forms
/
{formId}
/
submissions
{
	"submissions": [
		{
			// required
			"questions": [
				{
					"id": "abcdef",
					"value": "Timmy"
				}
			],
			// the following are optional
			"urlParameters": [
				{
					"id": "email",
					"name": "email",
					"value": "example@example.com"
				}
			],
			"submissionTime": "2024-05-16T23:20:05.324Z",
			"lastUpdatedAt":"2024-05-17T23:20:05.324Z",
			"scheduling": [
				{
					"id": "nLJtxBJgPA",
					"value": {
						"fullName": "John Smith",
						"email": "john@smith.com",
						"eventStartTime": "2024-05-20T09:00:00.000Z",
						"eventEndTime": "2024-05-20T09:30:00.000Z",
						"timezone": "Europe/London",
						// the following are optional
						"userId": 1,
						"scheduledUserEmail": "example@example.com"
						"eventId": "du5ckkaeacd5dlj16d7ajepp8g",
						"eventUrl": "https://www.google.com/calendar/event?eid=ZHU1Y2trYWVhY2Q1ZGxqMTZkN2FqZXBwOGcgYXJjaGllQGZpbGxvdXQuY29t&authuser=john%40smith.com",
						"rescheduleOrCancelUrl": "https://schedule.fillout.com/event/3EhDXDtvEtus?t=Cq52ZAGUnDpnnlatjDKD1yjtGCFNGajY"
						"meetingNotes": "Example meeting notes..."
					}
				}
			],
			"payments": [
				{
					"id": "cLJtxCKgdL",
					"value": {
						"paymentId": "pi_3PRF2cFMP2ckdpfG0s0ZdJqf",
						// the following are optional
						"stripeCustomerId": "cus_Ppjz3Z80000000",
						"stripeCustomerUrl": "https://dashboard.stripe.com/customers/cus_Ppjz3Z80000000",
						"stripePaymentUrl": "https://dashboard.stripe.com/payments/pi_3PRF2cFMP2ckdpfG0s0ZdJqf",
						"totalAmount": 1000,
						"currency": "USD",
						"email": "john@doe.com",
						"status": "succeeded",
						"stripeSubscriptionId": "sub_Ppjz3Z80000000"
					}
				}
			],
			"login": {
          "email": "verified@email.com"
      }
		}
	]
}
{
	"submissions" : [...]
}

​
Request

​
URL parameters

​
formId
string
required

The public identifier of the form for which you want to import submissions. This should be a string. If your form’s URL is https://form.fillout.com/t/gHretr3UKYus, the form ID is gHretr3UKYus

​
Body parameters

​
submissions
array
required

The maximum number of submissions that can be created in a single request is 10. The submissions to be imported should be formatted as so:

{
	"submissions": [
		{
			// required
			"questions": [
				{
					"id": "abcdef",
					"value": "Timmy"
				}
			],
			// the following are optional
			"urlParameters": [
				{
					"id": "email",
					"name": "email",
					"value": "example@example.com"
				}
			],
			"submissionTime": "2024-05-16T23:20:05.324Z",
			"lastUpdatedAt":"2024-05-17T23:20:05.324Z",
			"scheduling": [
				{
					"id": "nLJtxBJgPA",
					"value": {
						"fullName": "John Smith",
						"email": "john@smith.com",
						"eventStartTime": "2024-05-20T09:00:00.000Z",
						"eventEndTime": "2024-05-20T09:30:00.000Z",
						"timezone": "Europe/London",
						// the following are optional
						"userId": 1,
						"scheduledUserEmail": "example@example.com"
						"eventId": "du5ckkaeacd5dlj16d7ajepp8g",
						"eventUrl": "https://www.google.com/calendar/event?eid=ZHU1Y2trYWVhY2Q1ZGxqMTZkN2FqZXBwOGcgYXJjaGllQGZpbGxvdXQuY29t&authuser=john%40smith.com",
						"rescheduleOrCancelUrl": "https://schedule.fillout.com/event/3EhDXDtvEtus?t=Cq52ZAGUnDpnnlatjDKD1yjtGCFNGajY"
						"meetingNotes": "Example meeting notes..."
					}
				}
			],
			"payments": [
				{
					"id": "cLJtxCKgdL",
					"value": {
						"paymentId": "pi_3PRF2cFMP2ckdpfG0s0ZdJqf",
						// the following are optional
						"stripeCustomerId": "cus_Ppjz3Z80000000",
						"stripeCustomerUrl": "https://dashboard.stripe.com/customers/cus_Ppjz3Z80000000",
						"stripePaymentUrl": "https://dashboard.stripe.com/payments/pi_3PRF2cFMP2ckdpfG0s0ZdJqf",
						"totalAmount": 1000,
						"currency": "USD",
						"email": "john@doe.com",
						"status": "succeeded",
						"stripeSubscriptionId": "sub_Ppjz3Z80000000"
					}
				}
			],
			"login": {
          "email": "verified@email.com"
      }
		}
	]
}
{
	"submissions" : [...]
}

Once imported, your submissions will be visible in the “Results” tab of the form editor.