form_submission_exported

Exports are generated asynchronously, so subscribe to this event instead of polling the export request.

relationships.object.data identifies the export request, and included contains it. Check its status: success means url links to the file, failure means the export failed and url is null.

The url is a signed link that expires 15 minutes after the event was created, and a retried delivery carries the same link. If it has expired, retrieve the export request from the API to get a fresh one.

The payload below is the default JSON:API document. The webhook's payload_include, payload_fields and payload_transformation_template change it, and its filter decides whether the event is sent at all.

Request

We send the event to your webhook's url with POST (or the webhook's http_method) and a JSON:API document as the body (Content-Type: application/vnd.api+json). See Receiving Webhooks for retries and Webhook Event Signatures to verify the request.

Headers

Header	Description
`X-TINT-Signature`	`timestamp,signature`, where `timestamp` is the Unix time (in seconds) at which the delivery was signed and `signature` is the Base64-encoded HMAC-SHA256 of `timestamp.body`, keyed with the webhook's signing secret. Only sent when the webhook has a signing secret. Every attempt is signed again, so retries carry a new timestamp. See Webhook Event Signatures.
`API-Version`	The API version the payload was serialized with, unless the webhook overrides this header.
`User-Agent`	Always `TINT Webhook/2.0`, unless the webhook overrides this header.

Payload

Field	Type	Description
`data`	object
`data.id`	string	The event ID. It stays the same on every retry of this event, so use it to detect duplicate deliveries. It is also the ID to use with Retrieve a webhook event.
`data.type`	string	Always `event`. One of `event`.
`data.attributes`	object
`data.attributes.name`	string	The event name. One of `form_submission_exported`.
`data.attributes.created_at`	string (date-time)	When the event happened (the event was recorded), not when this delivery was sent. Retries keep the original value.
`data.relationships`	object
`data.relationships.object`	object	The export request this event is about.
`data.relationships.object.data`	object
`data.relationships.object.data.type`	string	One of `form_submission_export_request`.
`data.relationships.object.data.id`	string
`data.relationships.team`	object	The team the webhook belongs to.
`data.relationships.team.data`	object
`data.relationships.team.data.type`	string	One of `team`.
`data.relationships.team.data.id`	string

Included resources

The sideloaded resources: the export request.

`form_submission_export_request`

Field	Type	Description
`id`	string	The ID of the export request.
`type`	string	One of `form_submission_export_request`.
`attributes`	object
`attributes.status` (optional)	string	`pending` while the export is being generated, then `success` or `failure`. One of `pending`, `success`, `failure`.
`attributes.url` (optional)	string or null (uri)	Once `status` is `success`, a signed URL to a ZIP file containing `form_submissions.csv` (and the submitted files when `include_files` was `true`), valid for 15 minutes. Every request returns a new URL. `null` until then.
`relationships` (optional)	object	A relationship's `data` is only present when it's listed in the `include` query parameter; otherwise its `meta.included` is `false`.
`relationships.experience` (optional)	object	The experience whose submissions are exported.
`relationships.experience.data` (optional)	object
`relationships.experience.meta` (optional)	object
`relationships.form` (optional)	object	The same resource as `experience`.
`relationships.form.data` (optional)	object
`relationships.form.meta` (optional)	object
`relationships.user` (optional)	object	The user who requested the export.
`relationships.user.data` (optional)	object
`relationships.user.meta` (optional)	object
`links` (optional)	object
`links.self` (optional)	string (uri)	The URL of the export request.

Example

{
  "data": {
    "id": "1377465",
    "type": "event",
    "attributes": {
      "created_at": "2025-03-14T16:42:07.000Z",
      "name": "form_submission_exported"
    },
    "relationships": {
      "object": {
        "data": {
          "type": "form_submission_export_request",
          "id": "OxZZQtuh5sXIKA"
        }
      },
      "team": {
        "data": {
          "type": "team",
          "id": "1"
        }
      }
    }
  },
  "included": [
    {
      "id": "OxZZQtuh5sXIKA",
      "type": "form_submission_export_request",
      "attributes": {
        "status": "success",
        "url": "https://exports.example.com/OxZZQtuh5sXIKA.zip?X-Amz-Expires=900&X-Amz-Signature=5d41402abc4b2a76"
      },
      "relationships": {
        "experience": {
          "meta": {
            "included": false
          }
        },
        "form": {
          "meta": {
            "included": false
          }
        },
        "user": {
          "meta": {
            "included": false
          }
        }
      },
      "links": {
        "self": "https://api.tintup.com/v2/teams/1/experiences/2012/form_submissions/export/requests/OxZZQtuh5sXIKA"
      }
    }
  ]
}

Responses

Status	Description
`404`	404 Not Found or 410 Gone stops delivery of this event immediately: it is marked `failure` and not retried. The attempt still counts toward the webhook's failure limit.
`410`	404 Not Found or 410 Gone stops delivery of this event immediately: it is marked `failure` and not retried. The attempt still counts toward the webhook's failure limit.
`2XX`	Any status below 400 (typically 2XX) acknowledges the event: we mark it `success` and don't send it again. The response body is ignored (we store it with the attempt, for your reference). Redirects are not followed, and a 3XX response also counts as acknowledged, so point the webhook at the final URL.
Other	Any other 4XX or 5XX status, a timeout or a connection error fails the attempt, and we retry up to 7 more times with an increasing delay (roughly 1 minute, 1 minute, 2 minutes, 13 minutes, 1 hour, 4 hours, then 13 hours later), after which the event is marked `failure`. More than 50 failed attempts for the same webhook within a week, without a successful delivery in between, set the webhook to `inactive`.