SharkHub
Webhooks

Criar webhook

Cria um webhook para o tipo informado. Usuários com perfil Customer só podem criar webhooks para a própria conta. Usuários com perfil Director ou Superuser podem criar para qualquer usuário.

POST
/api/v1/user/webhook/{type}

Cria um webhook para o tipo informado. Usuários com perfil Customer só podem criar webhooks para a própria conta. Usuários com perfil Director ou Superuser podem criar para qualquer usuário.

Authorization

BearerAuth
AuthorizationBearer <token>

Informe apenas o token. A referência da API enviará automaticamente o cabeçalho no formato Authorization: Bearer {token}.

In: header

Path Parameters

type*WebhookType

Tipo do webhook que será criado.

Value in"pix_in" | "pix_out" | "account"

Request Body

application/json

Response Body

application/json

application/json

application/json

curl -X POST "https://staging.sharktecnologia.com/api/v1/user/webhook/pix_in" \  -H "Content-Type: application/json" \  -d '{    "user_id": 10,    "webhook_route": "https://meusite.com/callback",    "webhook_api_key": "chave-opcional",    "webhook_secret_key": "segredo-opcional"  }'
{
  "id": "0b4f9c2b-1df5-4a2e-b4db-2e9bbd4f0a10",
  "created_at": "2026-04-16T00:00:00",
  "updated_at": "2026-04-16T00:00:00",
  "webhook_route": "https://meusite.com/callback",
  "webhook_api_key": "chave-opcional",
  "webhook_secret_key": "segredo-opcional"
}
{
  "detail": "Maximum of 2 webhooks per type reached"
}
{
  "detail": "Not authenticated"
}

Atualizar webhook PUT

Atualiza apenas os campos enviados no body. Usuários com perfil Customer só podem editar os próprios webhooks. Usuários com perfil Director ou Superuser podem editar webhooks de qualquer usuário.

Excluir webhook DELETE

Remove apenas o webhook indicado pelo `webhook_id`. Se houver outro webhook do mesmo tipo, ele será preservado.