Invite Events

Webhook events related to invitation management and acceptance

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

Hide invite

nanoid · string · required

Unique identifier for the invite (primary key)

user_nanoid · string · required

Nanoid of the user who accepted the invite

email · string · required

Email address of the invitee

role · string · required

Role assigned to the invitee

status · string · required

Status of the invite, e.g., pending, accepted, expired

anonymous · boolean

Indicates whether the invite was sent anonymously

invited_by · string · required

Nanoid of the user who created the invite

invited_to · string · required

Nanoid of the company or team the invite is associated with

invite.accepted (v1)

{
  "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": "[e-mail]",
    "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

team_admin

Full administrative access to team settings, member management, and billing

member

Standard team member with access to team resources and functionality

viewer

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.