GET
Llistat de webhooks
Scope:
developers:webhooks.readhttps://api.holded.com/api/v2/webhooksRetorna 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
cursor
stringopcionalCursor opac per a la paginació
limit
integeropcional= 50Nombre 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/jsonobject
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/json403Permisos insuficientsapplication/json429Límit de sol·licituds exceditapplication/json