Skip to main content
Invite events are triggered when team members interact with invitations, such as accepting invitations to join organizations or teams. These events help you track invitation workflows and member onboarding.

​
Overview

Rise supports the following invite-related webhook events:

invite.accepted

Invitation accepted and user joined team or company

​
invite.accepted

When a user accepts an invitation to join a company or team, this event is triggered. This event signals successful completion of the invitation workflow.

​
Field reference

​
object
string
required
The type of object this webhook represents (always “event”)
​
created
number
required
The Unix timestamp when the event was created
​
event_type
string
required
The type of event that occurred
​
event_version
string
required
The version of the event schema
​
request_id
string
A unique identifier for the API request that triggered this event (optional)
​
idempotency_key
string
required
A unique key to ensure the webhook is processed only once
​
invite
object
required
Invitation information and details
{
  "object": "event",
  "created": 1751590453,
  "request_id": "req-1751590452487",
  "event_type": "invite.accepted",
  "event_version": "1.0",
  "idempotency_key": "85420805-0b5e-4b11-b7f4-c6f05db7120b",
  "invite": {
    "nanoid": "in-abc123def456789",
    "user_nanoid": "us-xyz789abc123456",
    "email": "newmember@example.com",
    "role": "team_admin",
    "status": "accepted",
    "anonymous": false,
    "invited_by": "us-def456ghi789012",
    "invited_to": "te-ghi789def456123"
  }
}

​
Implementation Notes

Invitation lifecycle: This event is only triggered when invitations are successfully accepted. Rejected or expired invitations do not trigger webhook events.
Role permissions: Always validate that the assigned role matches your expected permissions before granting access to systems or resources.
User tracking: Use the user_nanoid to correlate this event with other user-related activities across your system.

​
Role Types

Full administrative access to team settings, member management, and billing
Standard team member with access to team resources and functionality
Read-only access to team resources without modification privileges

​
Use Cases

Invite events are commonly used for:
  • Automated onboarding - Trigger welcome emails, setup guides, or account provisioning
  • Access control - Grant appropriate permissions in external systems
  • Analytics tracking - Monitor team growth and invitation conversion rates
  • Compliance logging - Maintain audit trails of team membership changes

​
Anonymous Invitations

When anonymous is true, the invitation was sent to a user who wasn’t previously registered with Rise. These users create an account as part of accepting the invitation.
Account creation: Anonymous invitations trigger both account creation and team membership, so this event represents both user registration and team joining.