Create an organization
POST
/api/organizations
Creates a new organization. Only name is accepted; the plan defaults to FREE and a 30-day trial end date is set automatically on creation. The authenticated user is added as the organization OWNER.
Authorizations
ApiToken
Long-lived API token created via POST /api/api-tokens (returned once in plaintext).
Type
API Key (header: X-API-TOKEN)
or
JWT
JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer
Type
HTTP (bearer)
Request Body
JSON "name": "string", "require2fa": true
{
}
Responses
organization resource created
JSON "@context": "string", "@id": "string", "@type": "string", "id": 42, "name": "Acme GmbH", "plan": "FREE", "trialEndsAt": "2026-07-31T12:00:00+00:00", "scalecommerce": false, "require2fa": false, "createdAt": "2026-07-01T09:30:00+00:00", "updatedAt": "2026-07-01T09:30:00+00:00", "externalCustomerId": "CUST-000123"
{
}