ANando
Webhook sources

Create a webhook source

Changed on

Creates an inbound webhook source for a supported provider preset. Requires an API key bound to a live workspace admin or owner with webhooks:write. The ingress URL and signing secret response can be replayed with the same Idempotency-Key for 24 hours; after that the secret is not retrievable. Configure the URL and secret in the external service, then attach a route to deliver its events into a conversation.

post/webhook-sources

Request

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

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

display_namestring nullable

Optional label for the author identity events post as. The source itself keeps the provider's canonical name.

providerstring required

Inbound provider preset key.

signing_secretstring nullable

Signing secret the provider will use. Generated when omitted.

Response

Created inbound webhook source.

Example response

{
  "data": {
    "source_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
  }
}

Changes

  • aaceae49c08dRevision 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

  • 0a94056fba48Revision changes
    • breaking

      added the new required header request parameter Idempotency-Key