Create organization and initial owner invitation

Server URLloading...

POST

/organizations

Send

Authorization

Body

Creates a new customer organization under the specified partner (MSP), creates its owner invitation record, and attempts to send the invitation email.

What happens:

1. The organization is created with the selected plan and linked to the partner via partnerId.
2. The organization is marked as partner-managed - no Stripe billing is set up for the customer.
3. An invitation record is created for owner.email. Email delivery is best-effort.
4. Once the owner accepts, they have full product access but cannot manage billing or subscriptions.

The externalCustomerId must be unique across all your organizations (not just per partner). It is the idempotency key for this endpoint: retrying a create with the same value returns DUPLICATE_EXTERNAL_CUSTOMER_ID rather than creating a second organization. Sending the literal strings undefined or null is rejected with VALIDATION_ERROR — a serialised missing value would otherwise be stored verbatim and disable that protection for every later create.

Response Body

curl -X POST "https://example.com/organizations" \  -H "Content-Type: application/json" \  -d '{    "organization": {      "name": "Acme GmbH",      "timezone": "Europe/Berlin"    },    "owner": {      "email": "owner@example.com",      "firstName": "Alice",      "lastName": "Müller"    },    "externalCustomerId": "SYN-4711",    "partnerId": "665abc123def456789012345",    "plan": {      "slug": "advanced",      "commitment": "monthly"    }  }'

{  "status": "success",  "organization": {    "id": "69c175970f3e28310926a1aa",    "name": "Acme GmbH",    "industry": "IT Services",    "timezone": "Europe/Berlin",    "channelPartner": "acme",    "externalCustomerId": "SYN-4711",    "externalContractId": "CON-2026-0001",    "partnerId": "665abc123def456789012345",    "ownerEmail": "owner@acme.de",    "createdAt": "2026-03-23T17:17:11.605Z",    "plan": {      "id": "6967b1c7138bed3e7f6bf7e6",      "slug": "advanced",      "name": "Advanced",      "commitment": "monthly",      "currency": "EUR",      "baseFee": 6900    }  },  "owner": {    "email": "owner@acme.de",    "firstName": "Alice",    "lastName": "Müller",    "role": "admin",    "status": "invited",    "source": "distributor-api",    "invitationId": "69c175970f3e28310926a1bb",    "expiresAt": "2026-03-30T17:17:11.814Z"  }}