Webhooks

Create a webhook endpoint

Changed on

The response carries the signing secret once — store it now. Deliveries are signed per Standard Webhooks; see webhooks.

post/v1/webhook-endpoints

Request

  • Base URL: https://api-eu.dynamicdocumentapi.com
  • URL: https://api-eu.dynamicdocumentapi.com/v1/webhook-endpoints
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Headers

Idempotency-Keystring

Replays the stored response for 24 h; a different body with the same key → 422.

Request body

descriptionstring
enabledboolean
eventsstring[] required
headersobject

Extra request headers.

is_defaultboolean

Receive events from renders without an inline webhook.

managed_by'zapier' | 'make' | 'n8n' | 'bubble' | 'pipedream' | 'activepieces' | 'power_automate'

Create only. Set from the OAuth token when it belongs to an integration's app (e.g. Zapier's), which may send the same value; API keys can't set it.

  • zapier - zapier
  • make - make
  • n8n - n8n
  • bubble - bubble
  • pipedream - pipedream
  • activepieces - activepieces
  • power_automate - power_automate
template_idsstring[]

Only deliver events for these templates.

urlstring uri required

Absolute https URL with a public host and no credentials, on port 443, 80, 8080 or 8443.

Response

Created; secret is shown once.

created_atstring date-time required
descriptionstring required
disabled_reasonstring nullable required

Set when Dynamic Document API disabled the endpoint after repeated failures, or because its URL answered 410 Gone.

enabledboolean required
eventsstring[] required
headersobject required

Header names; the values are masked.

idstring required

whe_…

is_defaultboolean required
managed_by'zapier' | 'make' | 'n8n' | 'bubble' | 'pipedream' | 'activepieces' | 'power_automate' | 'null' nullable required

The integration (e.g. zapier) that created the endpoint for its instant triggers; null for your own endpoints. It is never the default endpoint, the dashboard shows it read-only, and it is deleted when you disconnect the integration or when its URL answers 410 Gone.

  • zapier - zapier
  • make - make
  • n8n - n8n
  • bubble - bubble
  • pipedream - pipedream
  • activepieces - activepieces
  • power_automate - power_automate
objectstring
secretstring required

whsec_…, base64 of 32 random bytes. Shown once.

template_idsstring[] required

Empty list = every template.

updated_atstring date-time required
urlstring uri required

Changes

  • 0f14bc0000f4Revision changes
    • info

      added the new optional request property

    • info

      added the required property to the response with the status