Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.steppd.com/llms.txt

Use this file to discover all available pages before exploring further.

Steppd fires webhook events for team membership changes. These events let you keep external systems, such as an HRIS, an onboarding tool, or an audit log, in sync with your Steppd organization’s roster. All events share the same common envelope.

​
member.invited

Fires when an admin sends an invitation to a new team member. Event name: member.invited

​
Key fields in data

​
email
string
The email address to which the invitation was sent.
​
invited_by
string
The user ID of the admin who sent the invitation.

​
Example payload

{
  "event": "member.invited",
  "timestamp": "2024-02-01T09:00:00Z",
  "organization_id": "org_abc123",
  "data": {
    "email": "alex@example.com",
    "invited_by": "user_abc"
  }
}

​
member.role_changed

Fires when an admin promotes a member to admin or demotes an admin to member. Steppd prevents demotion of the last remaining admin in an organization. Event name: member.role_changed

​
Key fields in data

​
user_id
string
The user ID of the member whose role changed.
​
new_role
string
The role after the change. Either "admin" or "member".
​
changed_by
string
The user ID of the admin who made the change.

​
Example payload

{
  "event": "member.role_changed",
  "timestamp": "2024-03-05T16:45:00Z",
  "organization_id": "org_abc123",
  "data": {
    "user_id": "user_jkl",
    "new_role": "admin",
    "changed_by": "user_abc"
  }
}