SharkHub
Webhooks

Atualizar webhook

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.

PUT
/api/v1/user/webhook/{user_id}/{webhook_type}/{webhook_id}

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.

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

user_id*integer

ID do usuário dono do webhook.

webhook_type*WebhookType

Tipo do webhook.

Value in"pix_in" | "pix_out" | "account"
webhook_id*string

UUID do webhook.

Formatuuid

Request Body

application/json

Response Body

application/json

application/json

application/json

curl -X PUT "https://staging.sharktecnologia.com/api/v1/user/webhook/0/pix_in/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "webhook_route": "https://novo-url.com/callback",    "webhook_api_key": "nova-chave",    "webhook_secret_key": "novo-segredo"  }'
{
  "id": "0b4f9c2b-1df5-4a2e-b4db-2e9bbd4f0a10",
  "created_at": "2026-04-16T00:00:00",
  "updated_at": "2026-04-16T12:30:00",
  "webhook_route": "https://novo-url.com/callback",
  "webhook_api_key": "nova-chave",
  "webhook_secret_key": "nova****gredo"
}
{
  "detail": "webhook_id not found"
}
{
  "detail": "Not authenticated"
}

PIX Out (Envio) POST

Realiza uma transferência PIX para a chave de destino informada e retorna o identificador da operação.

Criar webhook POST

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.