Questa pagina è disponibile solo in inglese.
Create a company
POST /rest/v1/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.
Authorization
apiKey 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
Unique client-generated key (max 255 chars), stored 24h.
length <= 255Request 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"}Ultimo aggiornamento il 16 ottobre 2026