Delivery

Create a delivery destination

post/v1/delivery/destinations

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/delivery/destinations
  • Auth: HTTP bearer

Request body

namestring required
typestring required

Connector type. Must match a registered connector. Live types are webhook, sftp, s3, azure_blob, google_drive, onedrive, google_sheets.

configobject

Connector-specific transport settings (e.g. { url, method, headers } for webhook).

signing_secretstring nullable

HMAC-SHA256 secret for webhook destinations. Deliveries then carry X-Talonic-Signature: t=<ms>,v1=<hex> with hex = HMAC(secret, "<t>.<body>") (see the Signature verification section). Equivalent to auth_config.signing_secret; supplying both with different values is a 400.

payload_cap_bytesinteger nullable
is_activeboolean

Example request

{
  "signing_secret": "whsec_rotate_monthly"
}

Response

Destination created (alias of 201).

idstring uuid required
customer_idstring uuid required
namestring required
typestring required

Connector type discriminant — resolves to a registered connector. Live types are webhook, sftp, s3, azure_blob, google_drive, onedrive, google_sheets.

configobject

Connector-specific configuration (e.g. { url, headers } for webhook).

has_auth_configboolean

True when connector credentials are stored for this destination. The credential values themselves are never returned.

has_signing_secretboolean

True when an HMAC signing secret is stored. The secret itself is never returned.

payload_cap_bytesinteger nullable

Per-destination override of the TransportWrapper payload cap (bytes).

is_activeboolean required
last_delivery_atstring date-time nullable
last_delivery_statusstring nullable
created_atstring date-time required
updated_atstring date-time required

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "customer_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Analytics webhook",
  "type": "webhook",
  "last_delivery_at": "2026-04-25T14:30:00.000Z",
  "created_at": "2026-04-25T14:30:00.000Z",
  "updated_at": "2026-04-25T14:30:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.