POST
/
webhooks
This endpoint requires your private API key.

Once a webhook is created, events will be sent to it based on the criteria specified in the webhook. The data sent follows the Event schema and is sent as a JSON array in the POST request in the data field. Below is an example request body:

{
  "data": [
    {
      "uuid": "b99b40c5-e306-4351-9f1d-9a13bb9e8bd1",
      "type": "track",
      "event": "ConnectedAccount",
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "properties": {
        "totalAccounts": 4
      },
      "timestamp": "2024-10-21T21:32:17.000Z",
      "parsedAt": "2024-10-21T21:32:23.194Z"
    }
  ]
}

Body

application/json
​
url
string
required

The URL that the webhook will send events to.

​
enableBatching
boolean

Whether to enable batching for the webhook. Defaults to false.

​
eventNames
string[]

The event names that the webhook will send. Defaults to ["*"] (all event names).

​
eventTypes
string[]

The event types that the webhook will send. Defaults to ["*"] (all event types).

​
flatten
boolean

Whether to flatten the event data. This is useful for downstream systems that don't support nested data structures. Defaults to false.

Response

200 - application/json
​
createdAt
string
required

The date and time the webhook was created.

​
enableBatching
boolean
required

Whether to enable batching for the webhook.

​
eventNames
string[]
required

The event names that the webhook will send. Use * to match all event names.

​
eventTypes
string[]
required

The event types that the webhook will send. Use * to match all event types.

​
flatten
boolean
required

Whether to flatten the event data. This is useful for downstream systems that don't support nested data structures.

​
url
string
required

The URL that the webhook will send events to.

​
uuid
string
required

The UUID of the webhook. Automatically generated.

Was this page helpful?

Get WebhooksDelete Webhook