Create a webhook endpoint

post

https://api.sintalk.com.br/v3/webhooks

Registers a webhook endpoint. Deliveries carry recipients' phone numbers in full, so registering one also requires the phones:view scope. The response is the only place the signing secret ever appears — store it before doing anything else.

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201The endpoint was registered; this is the only response that carries the signing secret.

400The request was rejected before it was applied — either a field failed validation (validation_failed, with error.fields naming each one), or the request could not be read at all (bad_request: malformed JSON, an unknown field, a missing parameter, or an unparseable path or query value).

401No credential was presented, or the one presented was rejected.

403The credential is valid but is not allowed to call this operation.

422The body parsed and every field is individually valid, but the request cannot be applied as asked. Retrying it unchanged will fail again.

429Rate limit exceeded

defaultAn unexpected error. Safe to retry with backoff; use an idempotency key where the operation accepts one.