Saltar al contingut principal
GET

Llistat de webhooks

Scope:developers:webhooks.read
https://api.holded.com/api/v2/webhooks

Retorna una llista paginada de webhooks del compte. Els resultats utilitzen paginació per cursor (`cursor` i `has_more`). El camp `secret` no s'inclou al llistat; utilitza l'endpoint de detall per obtenir-lo.

Paràmetres

Paràmetres de consulta

cursorstringopcional

Cursor opac per a la paginació

limitintegeropcional= 50

Nombre màxim de webhooks a retornar per pàgina. Per defecte 50, màxim 200

Petició

python
import requests

url = "https://api.holded.com/api/v2/webhooks?cursor=value&limit=50"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Respostes

Resposta

json
{
  "items": [
    {
      "id": "507f1f77bcf86cd799439011",
      "url": "https://example.com/webhook",
      "events": [
        "invoice.create",
        "invoice.update"
      ],
      "version": "v1",
      "description": "My webhook",
      "enabled": true,
      "created_at": "2026-01-15T10:30:00+00:00",
      "updated_at": "2026-01-15T10:30:00+00:00"
    }
  ],
  "cursor": "string",
  "has_more": false
}

Respostes exitoses

200Llistat de webhooksapplication/json
object
items[]object[]
idstring
urlstring<uri>
events[]string[]
versionstring
descriptionstring
enabledboolean
created_atstring<date-time>
updated_atstring<date-time> | null
cursorstring | null
has_moreboolean

Respostes d'error

401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
429Límit de sol·licituds exceditapplication/json