workspaces

Triggered when the messaging quota for a workspace reaches or exceeds 100 percent utilization within the current billing period.

postWebhookworkspace:quota_full:messaging

Headers

X-TL-Partner-Idstring required

The unique identifier for the partner.

X-TL-Signaturestring required

a JSON Web Token (JWT) token that contains the partner_id, nbf (not before), and exp (expiration) fields. using the partner''s shared secret and can be used to verify authenticity and integrity.

Payload

workspace_idstring required

Identifier of the workspace whose messaging quota is nearing full utilization or reached.

event_type'workspace:quota_near_full:messaging' | 'workspace:quota_full:messaging' required

Partner webhook event name.

partner_idstring required

Unique identifier of the partner that owns the workspace.

triggered_atstring date-time required

Timestamp when the event was triggered.

messaging_quota_totalinteger required

Total messaging quota allocated to the workspace for the current billing period.

messaging_quota_usedinteger required

Number of messaging units consumed in the current billing period when the threshold was reached.

utilization_pctinteger

Messaging quota utilization percentage at the time of triggering, computed as an integer 0–100.

current_period_startstring date-time required

Start of the current billing period used to aggregate the utilization

current_period_endstring date-time required

End of the current billing period used to aggregate the utilization

Example payload

{
  "workspace_id": "my-workspace",
  "event_type": "workspace:quota_full:messaging",
  "partner_id": "partner_12345",
  "triggered_at": "2024-01-01T12:00:00Z",
  "messaging_quota_total": 100000,
  "messaging_quota_used": 90000,
  "utilization_pct": 90,
  "current_period_start": "2024-01-01T00:00:00Z",
  "current_period_end": "2024-01-31T23:59:59Z"
}

Response

Receiver accepted the event

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.