Esdeveniments · Facturació
subscription.updated
Subscripció actualitzada
Ha canviat la subscripció al núvol: edició, estat, llicències o període (data.previous_attributes conté els valors anteriors).
- Tipus d’objecte
- subscription
- Es lliura a
- Webhooks amb el rol admin
Càrrega útil
Objecte: EventSubscriptionUpdated
idstringobligatoriID de l’esdeveniment (
evt_…), que també s’envia com a capçalerawebhook-id. Feu-lo servir per descartar els lliuraments duplicats.typestringobligatoriValors permesos:
subscription.updatedcreated_atstring (date-time)obligatoriMoment en què es va produir el canvi (UTC).
org_idintegerobligatoriapi_versionstringobligatoriVersió del contracte de l’esquema de
data.sequenceintegerNúmero de seqüència del lliurament dins del webhook (no hi és en un esdeveniment de prova).
payloadstringobligatorithinvol dir sensedata: llegiu l’objecte a través de l’API.Valors permesos:
fullthindataobjectCamps
previous_attributesobjectobligatoriValors anteriors dels camps de primer nivell de l’objecte que han canviat.
actor_idinteger | nullobligatoriUsuari que ha fet l’acció;
nullper a una clau d’API de l’organització o la mateixa plataforma.
testbooleanobligatoriEsdeveniment de prova enviat per
POST /v1/webhooks/{webhook_id}/test.
Exemple de lliurament
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "subscription.updated",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "subscription",
"id": "1"
},
"payload": "full",
"data": {
"subscription": {
"edition": "business",
"status": "active",
"seats_purchased": 25,
"billing_interval": "month",
"trial_ends_at": null,
"current_period_start": "2026-10-01T00:00:00Z",
"current_period_end": "2026-11-01T00:00:00Z",
"canceled_at": null,
"credits_allowance": 5000
},
"previous_attributes": {
"seats_purchased": 20
},
"actor_id": 7
},
"test": false
}Recepció d’esdeveniments
Cada lliurament és una sol·licitud POST amb aquest cos JSON a l’URL del vostre webhook. Verifiqueu la capçalera webhook-signature (Standard Webhooks) abans de confiar en el cos, responeu amb un estat 2xx en pocs segons i feu la feina després. Els lliuraments a un mateix webhook mantenen l’ordre dels esdeveniments; un lliurament fallit es reintenta amb pauses cada vegada més llargues.
En qualsevol moment poden aparèixer tipus d’esdeveniment i camps nous: ometeu els tipus i els camps que no conegueu.
Els mateixos esdeveniments són al canal d’esdeveniments durant 30 dies →