API ReferencePartner

Diese Seite ist nur auf Englisch verfügbar.

Create a company

POST /rest/v1/accounts

POST
/accounts

Creates a company (its own Nembol store) on the plan you choose, billed to you from today (prorated). No trial, no login, no emails. On a sandbox partner it is not billed and at most 3 companies can be open at once (a 4th answers 409 sandbox_limit). The input is validated first: an invalid value is always a 422, even when a limit is reached. Unknown fields are ignored. Then connect its channels (POST /channel_connections with Nembol-Account) and work inside it with that header. Requires accounts:manage.

AuthorizationBearer <token>

Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.

In: header

Header Parameters

Idempotency-Key?string

Unique client-generated key (max 255 chars), stored 24h.

Lengthlength <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/accounts" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "plan": "basic"  }'
{  "id": "acct_66f0a1",  "object": "account",  "name": "string",  "reference": "string",  "plan": "basic",  "country": "string",  "currency": "string",  "status": "active",  "product_limit": 0,  "channel_accounts": 0,  "products": 0,  "created_at": "2019-08-24T14:15:22Z",  "closed_at": "2019-08-24T14:15:22Z"}

Zuletzt aktualisiert am 16. Oktober 2026

Brauchst du Hilfe?

Schreib uns, und ein Mensch antwortet, meist innerhalb eines Werktags.