Reference

Onboarding events

View as Markdown

Seven events fire on the onboarding resource. Phase and state changes carry data.previous_attributes so you can act on the transition, not just the new state.

EVENT TYPES
TypeFires when
onboarding.createdA new onboarding is created for a customer.
onboarding.phase_changedOnboarding moves to a different phase. previous_attributes.phase holds the prior phase.
onboarding.state_changedOnboarding’s state changes (active, paused, blocked, completed).
onboarding.at_riskAt-risk flag is set on the onboarding.
onboarding.back_on_trackAt-risk flag is cleared.
onboarding.launchedOnboarding is marked launched (live with end users).
onboarding.completedOnboarding hits its terminal completed state.
PAYLOAD
onboarding.phase_changed
{
  "id": "evt_2nQv...",
  "type": "onboarding.phase_changed",
  "data": {
    "object": {
      "id": "onb_2N...",
      "customer_id": "cus_2N...",
      "display_id": 1108,
      "name": "Acme Corp · Q3 rollout",
      "phase": "integration",
      "state": "active",
      "target_launch_date": "2026-07-15",
      "owner_email": "csm@yourdomain.com"
    },
    "previous_attributes": {
      "phase": "kickoff"
    }
  }
}