Immutable solution version
Clerk event: organizationMembership.created, grant the seat from the nested payload
Complete solution
A user joined an organization. The payload nests the org, the user, and the role; read all three from their nested paths and grant access accordingly.
organizationMembership.created: the join event
Fires when a user becomes a member of an organization, by invitation acceptance, admin add, or self-join depending on your settings.
What to do on receipt
Read the three nested pieces:
- Org:
evt.data.organization.id(andnamefor display) - User:
evt.data.public_user_data.user_id - Role:
evt.data.role, e.g.org:adminororg:member
- Org:
- Create the membership row in your app keyed by org id plus user id. Grant the entitlements that match the role.
- If you provision per-seat resources or count seats for billing, increment here. This event is your seat counter's source of truth.
- Return 200.
The trap
Reading the payload flat. Agents sometimes look for evt.data.user_id or evt.data.organization_id at the top level and get undefined. The membership payload nests: organization under organization, the user under public_user_data, the role as role. Destructure the nesting deliberately.
Checklist
- The user behind
public_user_data.user_idalready exists in Clerk; make sure your user sync (the user trio) has run or handle a missing user row with an upsert. - Invitation acceptances arrive as
organizationInvitation.acceptedAND then this event. Do not double-provision: the membership event is the one that grants access. - Roles are strings like
org:admin. Compare against the exact role key, not a substring.
Evidence
Clerk's event catalog (Dashboard → Webhooks → Event Catalog) lists organizationMembership.created. The payload nests organization, publicuserdata, and role. The verifyWebhook reference documents the evt.data payload shape. Verified live at https://clerk.com/docs/reference/backend/verify-webhook.
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_vbefljT-FhgaFkY6b13kkg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Clerk event: organizationMembership.created, grant the seat from the nested payload <span>— Vectle</span></a>