List account webhooks
GET /api/webhooks
Returns all webhooks configured for the authenticated account.
Authentication
Requires a Bearer token in the Authorization header.
Response (200)
| Field | Type | Description |
|---|---|---|
accountId | number | Account ID |
webhooks | array | List of configured webhooks |
webhooks[].id | number | Unique webhook identifier |
webhooks[].type | string | Event type: cash_in, cash_out, refund_in, refund_out |
webhooks[].url | string | Configured endpoint URL |
webhooks[].headers | object | Custom headers (key-value) |
webhooks[].isActive | boolean | Indicates whether the webhook is active |
webhooks[].createdAt | string | Creation date (ISO 8601) |
total | number | Total number of configured webhooks |
{
"accountId": 93,
"webhooks": [
{
"id": 1,
"type": "cash_in",
"url": "https://api.example.com/webhooks/pix",
"headers": {
"Authorization": "Bearer token123"
},
"isActive": true,
"createdAt": "2025-01-09T12:00:00.000Z"
}
],
"total": 4
}Errors
| Status | Description |
|---|---|
| 401 | Missing or invalid token |
| 404 | Account not found |