Company Management

company.owner_changed

This event is triggered when a company's Account Owner role is transferred to a different user, including rotation and demotion scenarios.

postWebhookcompany.owner_changed

Payload

company_idstring required

The unique identifier of the related company.

event_typestring required

The webhook event type identifier.

new_owner_idstring required

The unique identifier of the user who is now the Account Owner.

previous_owner_idstring nullable

The unique identifier of the user who was previously the Account Owner. Null if there was no previous owner.

Example payload

{
  "company_id": "0073fcb5-b669-4e4a-b963-2a47744e75a1",
  "event_type": "company.owner_changed",
  "new_owner_id": "2614f814-b08e-4c8e-8c4d-ddbcc4692d99",
  "previous_owner_id": "9a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d"
}

Response

Any 200 response confirms that the webhook was delivered.

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.