Agency Management events

The Agency Management API publishes integration events when agent data changes. You can receive them over HTTPS by creating a webhook subscription.

Event	Raised when	data
AgentCreated	An agent is registered.	agency, agentCode, eventTimestamp
AgentUpdated	An agent or its related data changes.	agency, agentCode, eventTimestamp
AgentDeleted	An agent is deleted.	agency, agentCode, eventTimestamp
HierarchyBuildCompleted	The flattened team hierarchy has finished rebuilding.	agency, eventTimestamp

Event payloads are deliberately thin. They say which agent changed and when, but not what changed. When you receive one, call GET /agents/{agentCode} (or the relevant resource) to get the current state.

{
  "agency": "3f2c8a8e-5b7d-4b8e-9d9a-0f6c1e2a4b11",
  "agentCode": "A1051",
  "eventTimestamp": "2026-09-24T15:02:11Z"
}

See Webhook event types for the full delivery envelope and which events are currently available through webhooks.

Ordering and duplicates

• Events may arrive out of order. Use eventTimestamp, or better, re-read the current state, instead of assuming order.
• Events may be delivered more than once. Make your handlers idempotent.