Consultar um Evento

Consulta o desfecho de uma chamada que voce fez. Toda escrita devolve um event_id.

GET /api/webhooks/agency/:agency_key/events/:event_id

Autenticacao

Requer qualquer token Bearer da agencia — sem escopo especifico. Veja API de Entrada da Agencia.

Parametros de Caminho

Parametro	Tipo	Descricao
event_id	uuid	O event_id devolvido pela chamada original

Status

Status	Significado
pending	Na fila para retentativa apos falha transitoria
processing	Rodando neste momento
processed	Concluido com sucesso
failed	Terminal. Erro de negocio, ou cinco tentativas esgotadas.
ignored	Reconhecido mas sem efeito

Resposta

{
  "ok": true,
  "data": {
    "id": "3f7b1c2e-9a44-4d1b-8f2e-6c5a1b0d9e83",
    "action": "sub_account.create",
    "status": "processed",
    "attempts": 1,
    "target_account_id": "a1b2c3d4-5678-4e9f-a0b1-c2d3e4f5a6b7",
    "result": {
      "id": "a1b2c3d4-5678-4e9f-a0b1-c2d3e4f5a6b7",
      "name": "Acme Marketing",
      "channels": { "linkedin": 2, "whatsapp": 1, "instagram": 0, "email_marketing": 0 }
    },
    "error_code": null,
    "last_error": null,
    "received_at": "2026-07-28T14:22:00Z",
    "last_attempt_at": "2026-07-28T14:22:00Z",
    "processed_at": "2026-07-28T14:22:03Z"
  }
}

Um evento que falhou traz o motivo no lugar:

{
  "ok": true,
  "data": {
    "id": "3f7b1c2e-9a44-4d1b-8f2e-6c5a1b0d9e83",
    "action": "sub_account.create",
    "status": "failed",
    "attempts": 1,
    "error_code": "EMAIL_ALREADY_REGISTERED",
    "last_error": "Este email ja esta cadastrado em outra conta.",
    "processed_at": "2026-07-28T14:22:01Z"
  }
}

O action e um entre sub_account.create, sub_account.channels.update e sub_account.delete.

Exemplo

cURL

curl --request GET \
  --url "https://api.getraze.co/api/webhooks/agency/AGENCY_KEY/events/EVENT_ID" \
  --header "Authorization: Bearer SEU_TOKEN"

JavaScript

const response = await fetch(
  `https://api.getraze.co/api/webhooks/agency/${agencyKey}/events/${eventId}`,
  { headers: { 'Authorization': `Bearer ${token}` } }
);
const data = await response.json();

Python

import requests

response = requests.get(
    f'https://api.getraze.co/api/webhooks/agency/{agency_key}/events/{event_id}',
    headers={'Authorization': f'Bearer {token}'}
)
data = response.json()

Erros

Status	Codigo	Descricao
401	UNAUTHORIZED	Token ausente, desconhecido ou revogado
404	EVENT_NOT_FOUND	Nenhum evento com esse id pertence a esta agencia