clientspace/post
Tool: create
Create a new clientspace under the authenticated parent organization.
Returns the created Clientspace object on 201. title must be unique within the agency. apiKey is redacted from the response — see schemas/clientspace.
Plan required. The plan gate returns
403 PLAN_REQUIREDplus an upgrade URL. Required-field validation runs before the plan gate — a missingtitleis rejected with400 MCP_VALIDATION_FAILEDbefore any upstream call, so it never reaches the 403. Do not re-authenticate; upgrade the plan.
Need isolated client accounts without whitelabeling? Workspaces are available on every plan — see workspace-delegation.
Body
| field | type | req | constraints | description |
|---|---|---|---|---|
| title | string | ✓ | ≤256 chars | Display name for the clientspace (must be unique within the agency). |
| separateCredits | boolean | – | Give this clientspace its own credit pool. | |
| autoAllocate | boolean | – | Auto-allocate credits to this clientspace on a recurring basis. | |
| creditAmount | integer | – | Credits to allocate per auto-allocation cycle. |
Response
201 — Created Clientspace object: see schemas/clientspace. Deltas: none.
Errors: 400, 401, 403, 406, 409, 415, 422, 429, 500 — shared schema: schemas/errors. 403 = plan gate (see caveat above).
Invoke
Call create with name: "clientspace/post".