Webhooks

Create webhook

Create a webhook endpoint. The signing secret is returned only once.

post/webhooks

Headers

Idempotency-Keystring required

Unique key for safely retrying a request without creating duplicates.

X-Instance-IDstring nullable

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Request body

Response

Successful Response

Changes

Changed in 8 of the 28 revisions of this API.51620

Aug 27, 2026359d267dca881See the full diff
- ○
  deleted the header request parameter X-Agent-ID with deprecation
  request-parameter-removed-with-deprecation
Aug 23, 2026b1ad79e918ac1See the full diff
- ○
  header request parameter X-Agent-ID was deprecated
  request-parameter-deprecated
Aug 19, 2026c2c65e05271122See the full diff
- ▲
  removed the enum value mandate.created of the request property data/attributes/enabledEvents/items/
  request-property-enum-value-removed
- ▲
  removed the enum value mandate.revoked of the request property data/attributes/enabledEvents/items/
  request-property-enum-value-removed
- ○
  removed the mandate.created enum value from the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-removed
- ○
  removed the mandate.revoked enum value from the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-removed
Aug 19, 2026a77f94c2883a112See the full diff
- ▲
  removed the enum value ach.completed of the request property data/attributes/enabledEvents/items/
  request-property-enum-value-removed
- ●
  added the new ach.settled enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ○
  added the new ach.settled enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  removed the ach.completed enum value from the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-removed
Aug 15, 2026c309952835b588See the full diff
- ●
  added the new ach.completed enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new ach.created enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new ach.failed enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new ach.processing enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new ach.returned enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new external_party_account.validated enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new mandate.created enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new mandate.revoked enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ○
  added the new ach.completed enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new ach.created enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new ach.failed enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new ach.processing enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new ach.returned enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new external_party_account.validated enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new mandate.created enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new mandate.revoked enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
Aug 13, 2026ba1fb54c59391See the full diff
- ○
  the data/attributes/tags/propertyNames/ request property's maxLength was increased from 64 to 128
  request-property-max-length-increased
Aug 4, 202668aaf2076cfc55See the full diff
- ●
  added the new invitation_link.agent_added enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new invitation_link.agent_removed enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new invitation_link.created enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new invitation_link.redeemed enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ●
  added the new invitation_link.revoked enum value to the data/attributes/enabledEvents/items/ response property for the response status 201
  response-property-enum-value-added
- ○
  added the new invitation_link.agent_added enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new invitation_link.agent_removed enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new invitation_link.created enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new invitation_link.redeemed enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
- ○
  added the new invitation_link.revoked enum value to the request property data/attributes/enabledEvents/items/
  request-property-enum-value-added
Jul 26, 2026270e233e401c22See the full diff
- ▲
  the data/attributes/description request property's maxLength was decreased to 100
  request-property-max-length-decreased
- ▲
  the data/attributes/tags/propertyNames/ request property's maxLength was decreased to 64
  request-property-max-length-decreased
- ●
  for the header request parameter Idempotency-Key, the maxLength was set to 255
  request-parameter-max-length-set
- ●
  the data/attributes/url request property's maxLength was set to 2048
  request-property-max-length-set

Full history