> ## Documentation Index > Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create organization client > Create a new client workspace inside the organization, optionally with initial monthly credits and identity slots taken from the organization pools. The new workspace counts against the organization's client quota, and the API key creator becomes its first admin. The new client is Sales-led billed on the organization deal. With `companyWebsite` the workspace logo is set from it. The AI playbook is not filled automatically; fill it with `PUT /v1/ai-playbook` using a key of the new workspace, or in the app. Requires the API key creator (or the connected MCP user) to be an `ORGANIZATION_ADMIN` of the organization the key’s workspace belongs to. For organizations (agencies, resellers, white-label partners, enterprises) and their client workspaces only. The organization role is checked first: a caller without one is refused with 403 (`ORGANIZATION_READ_FORBIDDEN` on reads, `ORGANIZATION_ADMIN_FORBIDDEN` on writes), and a caller with one whose workspace is not in a live organization gets 404 `NOT_IN_ORGANIZATION`. > **Required scope:** `WORKSPACE_WRITE` > > **Rate limit:** 10 requests per minute ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json post /v1/organization/clients openapi: 3.1.0 info: title: Enginy API version: 1.0.0 description: Public API for Enginy platform servers: - url: https://openapi.enginy.ai description: Configured server security: [] tags: - name: AI Variables description: >- Manage AI variables and discover the entity fields you can reference in prompts and entity requests. - name: Inbox description: >- Inbox endpoints for listing contact threads, reading thread messages, managing tags, and sending manual replies. - name: Workspace description: >- The API key's workspace: its capacity, its organization, where its users open the app and where an admin buys more. - name: Organization description: >- For organizations (agencies, resellers, white-label partners, enterprises) and their client workspaces only. Create client workspaces, distribute credits and identity slots between them, and buy or request more capacity. Upsell and management only: no endpoint lowers the contracted quota. Clients billed through self-serve billing keep their own plan. Requires an organization role. - name: Workflows description: >- Build, validate, publish, run, and inspect advanced (graph) workflows, plus the block/condition catalog needed to author a workflow plan. paths: /v1/organization/clients: post: tags: - Organization summary: Create organization client description: >- Create a new client workspace inside the organization, optionally with initial monthly credits and identity slots taken from the organization pools. The new workspace counts against the organization's client quota, and the API key creator becomes its first admin. The new client is Sales-led billed on the organization deal. With `companyWebsite` the workspace logo is set from it. The AI playbook is not filled automatically; fill it with `PUT /v1/ai-playbook` using a key of the new workspace, or in the app. Requires the API key creator (or the connected MCP user) to be an `ORGANIZATION_ADMIN` of the organization the key’s workspace belongs to. For organizations (agencies, resellers, white-label partners, enterprises) and their client workspaces only. The organization role is checked first: a caller without one is refused with 403 (`ORGANIZATION_READ_FORBIDDEN` on reads, `ORGANIZATION_ADMIN_FORBIDDEN` on writes), and a caller with one whose workspace is not in a live organization gets 404 `NOT_IN_ORGANIZATION`. > **Required scope:** `WORKSPACE_WRITE` > > **Rate limit:** 10 requests per minute requestBody: content: application/json: schema: type: object properties: name: type: string minLength: 1 maxLength: 80 description: The new client workspace name. companyWebsite: type: string maxLength: 255 description: The client's company website; sets the workspace logo. companyLinkedinUrl: type: string maxLength: 255 description: The client's LinkedIn company page. initialMonthlyCredits: type: integer minimum: 0 maximum: 1000000000 description: Monthly credits allocated from the organization pool. initialIdentities: type: integer minimum: 0 maximum: 10000 description: Identity slots allocated from the organization pool. required: - name additionalProperties: false responses: '201': description: The client was created content: application/json: schema: type: object properties: status: type: string enum: - success message: type: string data: type: object properties: clientId: type: number name: type: string required: - clientId - name required: - status - message - data '400': description: >- Invalid request, or the capacity change is refused (`details.code`: `POOL_HEADROOM_EXCEEDED`, `MOVE_EXCEEDS_BUDGET`, `MOVE_EXCEEDS_IDENTITY_SLOTS`, `IDENTITY_CAP_BELOW_CONNECTED`, `BELOW_ADD_ON_CREDITS`, `ACCOUNT_LIMIT_REACHED`, `CREDITS_NOT_IN_INCREMENTS`, `PURCHASE_NEEDS_QUOTA` or `CAPACITY_IS_PURCHASED`) '401': description: Missing or invalid API key, or the workspace is frozen or deleted '403': description: >- The API key lacks the scope (`missingScopes`), its creator lacks the organization role (`details.code`: `ORGANIZATION_READ_FORBIDDEN` or `ORGANIZATION_ADMIN_FORBIDDEN`), or the operation is not available to this organization or client (`ACCOUNT_BILLED_SELF_SERVE`, `NO_CONTRACT_VIEW`, `PURCHASES_ARE_REQUESTED`, `PURCHASE_NEEDS_BILLING_AGREEMENT`) '404': description: >- The workspace is not in an organization (`details.code`: `NOT_IN_ORGANIZATION`, `ORGANIZATION_NOT_FOUND`), or the client is not one of its live clients (`ACCOUNT_NOT_FOUND`) '412': description: >- Enginy has not set the organization quota this change allocates from yet (`details.code`: `QUOTA_NOT_SET`) '429': description: Rate limit exceeded; retry after `X-RateLimit-Retry-After-Seconds` security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.