Organization

Provision organization for a new Clerk user

Public endpoint for freshly-signed-up Clerk users. Creates a new organization and default workspace, or returns the existing one if the Clerk user/org already maps to an internal organization. Requires a valid Clerk Bearer token in the Authorization header — no pre-existing backend organization is required.

post/v1/organizations/signup

Request

  • Base URL: https://api.abm.dev
  • URL: https://api.abm.dev/v1/organizations/signup
  • Auth: HTTP bearer

Request body

organizationNamestring

Optional display name for the organization. Defaults to the authenticated user's name or email prefix.

namestring

Optional display name for the owning user (fallback when the Clerk JWT does not carry a name claim).

emailstring email

Optional contact email (fallback when the Clerk JWT does not carry an email claim).

Response

Organization already existed — returning the existing record (idempotent response)

organizationIdstring uuid
organizationNamestring
organizationSlugstring
clerkOrgIdstring

Clerk org ID (org_xxx) linked to this internal organization, if any

clerkUserIdstring

Clerk user ID that triggered signup

workspaceIdstring uuid

Default workspace ID created alongside the organization

workspaceNamestring
createdboolean

True when a new organization was provisioned by this request; false when an existing record was returned (idempotency)

Changes

No recorded changes to this operation across all 1 revision of this API.