Platform Events

Platform events are webhooks StackOne fires from its own platform — not from a connector. Today they cover account lifecycle. For endpoint setup and signature verification, see Webhooks.

Events

Event	Fires when	Common use
`account.created`	A linked account is created	Kick off an initial data sync or refresh your UI
`account.updated`	A linked account is re-authenticated	Re-check scopes or resume a paused sync
`account.deleted`	A linked account is disconnected or removed	Revoke downstream access, clean up stored `account_id`s

Payload

Each delivery is a JSON body with these fields:

Field	Type	Description
`event`	string	`account.created`, `account.updated`, or `account.deleted`
`project_id`	string	The project the account belongs to
`account_id`	string	The linked account’s ID
`record_type`	string	Always `account` for these events
`record_id`	string \| number	The account ID (same as `account_id`)
`provider`	string	The provider key (e.g. `bamboohr`)
`event_date`	string	ISO 8601 timestamp of the event
`sent_at`	string	ISO 8601 timestamp the webhook was sent
`origin_owner_id`	string	Your identifier for the account owner (optional)
`origin_owner_name`	string	Human-readable owner name (optional)
`origin_username`	string	Identifier for the connecting user (optional)
`setup_information`	object	Additional connection setup details (optional)

Example account.updated:

{
  "project_id": "acmeinc-27270",
  "account_id": "GnQoASvosYhE5wJcmmAQs",
  "event": "account.updated",
  "event_date": "2023-11-01T13:10:31.408Z",
  "record_type": "account",
  "record_id": "GnQoASvosYhE5wJcmmAQs",
  "sent_at": "2023-11-01T13:10:31.418Z",
  "provider": "bamboohr",
  "origin_owner_id": "unique-org-identifier",
  "origin_owner_name": "Test organization",
  "origin_username": "sample-user"
}

Delivery & verification

Every delivery is signed with HMAC-SHA256 over the raw request body and sent in the x-stackone-signature header. Verify the signature and return 200. See Verifying webhook signatures.

Rate Limiting API SDKs

Accounts

Actions

Connect Sessions

Connector Profiles

MCP

Logs

Events

Payload

Delivery & verification

​Events

​Payload

​Delivery & verification

Events

Payload

Delivery & verification