Member Authentication

Members authenticate using Clerk JWT tokens obtained through various sign-in methods.

Authentication FlowCopy Anchor Link

Required HeadersCopy Anchor Link

Authorization: Bearer <CLERK_JWT_TOKEN>
Content-Type: application/json

Member ProvisioningCopy Anchor Link

// Step 1: Provision member
const validateResponse = await fetch('/members/me/auth/validate', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${clerkToken}`
  }
});

const { member } = await validateResponse.json();
// member.provisionedNow indicates if new member was created

Development TestingCopy Anchor Link

For local development, use the test header:

X-Test-Clerk-Id: test_2abc123...

Token ClaimsCopy Anchor Link

Clerk JWT tokens include:

• sub: User ID
• email: Primary email
• phone_number: Primary phone
• exp: Expiration timestamp
• iat: Issued at timestamp

Bruno ExamplesCopy Anchor Link

• bruno/Members (Surface)/Auth/Validate.bru
• bruno/Members (Surface)/Me/Profile/Get Me.bru

Error HandlingCopy Anchor Link