Skip to content

Team

Create a workspace

Creates a workspace and makes the signed-in user its owner. API keys are not accepted.

POST/api/tenants
  • Console only: signed-in session

Headers

  • Cookiestringrequired

    The whatsappx_session cookie the app sets when you sign in. Browsers send it automatically; API keys are not accepted on this endpoint.

    Example
    whatsappx_session=…

Body

application/json
  • namestringrequired

    Workspace name.

    Example
    Acme Support

Response

201 Createdapplication/json

  • iduuid

    Workspace id. Send it as X-Tenant-ID.

  • namestring

    Workspace name.

  • roleenum

    Your role in the workspace: owner, admin or agent.

Status codes

  • 201Created. The new workspace, with your role owner.
  • 400Bad request. The name is empty (workspace name is required) or the body is not JSON (invalid request).
  • 401Unauthorized. No signed-in session (unauthorized).