Criar webhook

Cadastra uma URL e os eventos que ela recebe. O segredo de assinatura aparece só nesta resposta.

Permissão da chave: Webhooks › escrever.

Autenticação

bearer

headerAuthorizationBearer <chave de API>

Chave de API da loja (Painel › Integrações › Chaves de API)

Corpo da requisição

application/json

body

name*string

Tamanho1 <= length <= 60

url*string

Tamanholength <= 2048

events?array<string>

Itensitems <= 50

Corpo da resposta

application/json

Exemplo de requisição

curl -X POST "https://api.rivoo.gg/v1/webhook-endpoints" \
  -H "Authorization: Bearer $RIVOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","url":"string"}'

Exemplo de requisição

curl -X POST "https://api.rivoo.gg/v1/webhook-endpoints" \  -H "Authorization: Bearer $RIVOO_API_KEY" \  -H "Content-Type: application/json" \  -d '{"name":"string","url":"string"}'

Exemplo de resposta

{
  "id": "whe_mhexample0000hook000001",
  "name": "Meu servidor",
  "url": "https://exemplo.com/webhooks/rivoo",
  "events": [
    "order.paid",
    "order.refunded"
  ],
  "status": "ENABLED",
  "disabledReason": null,
  "rotation": null,
  "createdAt": "2026-10-31T21:04:13.000Z",
  "updatedAt": "2026-10-31T21:04:13.000Z",
  "secret": "whsec_exemplo_nao_use"
}

{  "id": "whe_mhexample0000hook000001",  "name": "Meu servidor",  "url": "https://exemplo.com/webhooks/rivoo",  "events": [    "order.paid",    "order.refunded"  ],  "status": "ENABLED",  "disabledReason": null,  "rotation": null,  "createdAt": "2026-10-31T21:04:13.000Z",  "updatedAt": "2026-10-31T21:04:13.000Z",  "secret": "whsec_exemplo_nao_use"}

AutenticaçãoCopiar link

Corpo da requisiçãoCopiar link

Corpo da respostaCopiar link

Autenticação

Corpo da requisição

Corpo da resposta