v1

latestOpenAPI 3.1.0proprietary2026-07-24156175241.3 KB

Importer Webhooks

Get Importer Webhook

Returns a single Importer Webhook by its webhook_key.

get/v1/importer-webhooks/{webhook_key}

Path parameters

webhook_keystring required

The org-unique key identifying the webhook.

Response

The request has succeeded.

idinteger

The unique identifier of the importer webhook.

webhook_keystring

The org-unique key identifying this webhook.

type'batch' | 'metadata'

The delivery mode for the webhook. batch delivers rows in batches; metadata delivers only the import metadata.

urlstring

The URL that the importer will POST to.

auth_type'basic' | 'bearer_user_jwt' nullable

The authentication mode for requests to the webhook URL. basic requires a secret_key. bearer_user_jwt attaches the end-user JWT as a bearer token. Omit (null) for unauthenticated delivery.

secret_keystring nullable

The shared secret used for basic auth. Only returned to admin and developer API key users.

batch_sizeinteger nullable

Optional batch size (number of rows per webhook request) for batch-type webhooks.