Händelser · Fakturering

credits.low

Krediterna håller på att ta slut

Periodens kreditsaldo har passerat en tröskel för förbrukning (data.threshold, procent av tilldelningen som har förbrukats). Skickas en gång per tröskel och period.

Objekttyp: org
Levereras till: Webhookar med rollen admin

Nyttolast

Objekt: EventCreditsLow

idstringobligatorisk
Händelsens id (evt_…), skickas också som huvudet webhook-id. Använd det för att kasta dubblettleveranser.
typestringobligatorisk
Tillåtna värden: credits.low
created_atstring (date-time)obligatorisk
När ändringen inträffade (UTC).
org_idintegerobligatorisk
api_versionstringobligatorisk
Kontraktsversion för schemat data.
sequenceinteger
Leveransens löpnummer inom webhooken (saknas för en testhändelse).
objectWebhookEventObjectobligatorisk
payloadstringobligatorisk
thin betyder ingen data: läs objektet via API:et.
Tillåtna värden: fullthin
dataobject
Fält
- thresholdintegerobligatorisk
  Tröskel i procent av förbrukad tilldelning: 80 eller 100.
- period_startstring (date)obligatorisk
- balancenumber
- allowancenumber
testbooleanobligatorisk
En testhändelse som skickas av POST /v1/webhooks/{webhook_id}/test.

Exempel på leverans

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "credits.low",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "org",
    "id": "1"
  },
  "payload": "full",
  "data": {
    "threshold": 80,
    "period_start": "2026-10-01",
    "balance": 1000,
    "allowance": 5000
  },
  "test": false
}

Ta emot händelser

Varje leverans är ett POST-anrop med den här JSON-brödtexten till din mottagare. Verifiera huvudet webhook-signature (Standard Webhooks) innan du litar på brödtexten, svara med en 2xx-status inom några sekunder och gör arbetet efteråt. Leveranserna till en och samma webhook kommer i samma ordning som händelserna; en misslyckad leverans görs om med allt längre pauser.

Nya händelsetyper och nya fält kan tillkomma när som helst: hoppa över de typer och fält som du inte känner till.

Samma händelser finns i händelseflödet i 30 dagar →