Webhook sources

Route source events to a conversation

Changed on

Routes a source's events into a conversation the authenticated member belongs to. Requires an API key bound to a live workspace admin or owner with webhooks:write. Omit events to route everything; pass provider preset event ids to filter. The result can be replayed with the same Idempotency-Key for 24 hours while the route remains unchanged.

post/webhook-sources/{sourceId}/routes

Request

  • Base URL
    https://api.ando.so/v1
  • URL
    https://api.ando.so/v1/webhook-sources/{sourceId}/routes
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

sourceIdstring required

Webhook source identifier.

Headers

Idempotency-Keystring required

Idempotency key.

Required key for safe retries. Reusing it with different parameters returns 409 idempotency_conflict. The original result can be replayed for 24 hours while the created source or route remains unchanged.

Request body

conversation_idstring required

Target conversation identifier.

eventsstring[]

Provider preset event ids to route. Omit to route every event.

Example request

{
  "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
}

Response

Created event route.

Example response

{
  "data": {
    "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "route_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
  }
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • breaking

      added the new required header request parameter Idempotency-Key