team.member.invited

project_id is always null for team events. The invitee has not yet accepted at this point.

When this fires

A team owner or manager invites a collaborator by email. The collaborator becomes a member only once they accept and team.member.joined fires.

Required ability

team:view-any — token must carry this at mint time to subscribe an endpoint to this event.

Payload

{
  "id": "evt_01HX...",
  "type": "team.member.invited",
  "created_at": "2026-05-18T10:05:00Z",
  "api_version": "2026-05-01",
  "project_id": null,
  "data": {
    "team_id": "tem_01HX...",
    "email": "[email protected]",
    "role_id": "rol_01HX...",
    "role_code": "manager"
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `team.member.invited` for this event.
`created_at`	ISO 8601 timestamp	Server-side emission time.
`api_version`	string	Webhook API contract version.
`project_id`	null	Always `null` — account-level event.
`data.team_id`	string ULID	Team the invitation is for.
`data.email`	string	Email address the invitation was sent to.
`data.role_id`	string ULID	Role assigned to the collaborator on acceptance.
`data.role_code`	string	Stable role code (e.g. `manager`, `viewer`).

Caveats

An invitation can be revoked or expire without producing a follow-up event in this family.
The collaborator does not have access until they accept; expect team.member.joined.

team.member.joined — fires on acceptance.
team.member.removed — alternative outcome (revoked invitation).
Team events overview — back to family overview.