Skip to main content
POST
Receive a Clerk account event

Headers

svix-id
string
required

Svix message identifier (used for deduplication and signature binding).

svix-timestamp
string
required

Unix timestamp of the Svix delivery (used for replay protection).

svix-signature
string
required

Space-separated list of Svix v1 signatures.

Body

application/json
type
string
required

Clerk event type. Only user.created triggers a bootstrap; other types return 200 ignored.

data
object
required

Clerk user payload. The handler reads id, email_addresses, primary_email_address_id, first_name, and last_name; unknown fields are tolerated.

Response

Handled. Shape depends on event type: user.created → {workspace_id, workspace_name, created}; user.deleted → {deleted}; any other type → {status: ignored, type}.

workspace_id
string<uuid>

New or existing default workspace identifier.

workspace_name
string

Heroku-style workspace name, e.g. jolly-harbor-482.

created
boolean

true on fresh bootstrap; false on idempotent replay.

deleted
boolean

true on a user.deleted event.

status
string

ignored for event types other than user.created/user.deleted.

type
string

Echoed Clerk event type on ignored events.