Close a company
POST /rest/v1/accounts/{id}/close
Billing stops today (prorated). Its listings stay on the channels and its data is kept, like any Nembol user who leaves. Cannot be reopened. Because it is irreversible, it asks for a two-step confirmation: the first call answers 409 confirmation_required with a summary and a one-time token; repeat the same request with Nembol-Confirmation: <token>. Closing a company that is already closed is idempotent: 200 with the company, no confirmation.
Required scope: 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
Path Parameters
Header Parameters
Unique client-generated key (max 255 chars), stored 24h.
length <= 255The one-time token from a 409 confirmation_required answer, to confirm an irreversible action (repeat the same request with it, within 10 minutes).
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/accounts/string/close"{ "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"}Last updated on October 18, 2026
Need help?
Email us and a human replies, usually within one business day.