Definir webhook de saída (DLR + respostas)

PUT

/v1/account/webhook

Define a URL que receberá os eventos sms.status e sms.reply. Gera um segredo de assinatura na 1ª vez; use rotate_secret para girar. URL vazia desativa o webhook.

Requisição

Authorization

Bearer Token

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/json

Exemplo

{
    "url": "http://example.com",
    "rotate_secret": true
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/v1/account/webhook' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "http://example.com",
    "rotate_secret": true
}'

Respostas

🟢200

application/json

Webhook atualizado

Bodyapplication/json

Exemplo

{
    "url": "string",
    "secret": "string"
}

🟠401Unauthorized

🟠422ValidationError

🟠429TooManyRequests

Modificado em 2026-07-01 17:10:11