team.created
New team is created. Growth-tier+ only.
project_id is always null for team events — these are account-level. Only
emitted on Growth tier or higher.
When this fires
A new team is created beyond the implicit personal team. Available on Growth tier and above.
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.created",
"created_at": "2026-05-18T10:05:00Z",
"api_version": "2026-05-01",
"project_id": null,
"data": {
"team": {
"id": "tem_01HX...",
"name": "Research Team",
"owner_id": "usr_01HX..."
}
}
}Field reference
| Field | Type | Notes |
|---|---|---|
id | string ULID | Unique event id, prefixed evt_. Use for idempotent processing. |
type | string | Always team.created 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 identifier. |
data.team.name | string | Display name. |
data.team.owner_id | string ULID | User id of the team owner. |
Caveats
- Free and Starter tier accounts never see this event — teams are not enabled below Growth.
- The implicit personal team that exists for every account is not represented by this event; only explicit team creation is.
Related events
team.deleted— terminal state.team.member.invited— typical follow-up.- Team events overview — back to family overview.
How is this guide?