Skip to main content
POST
/
api
/
v2
/
clients
/
create
Create Client
curl --request POST \
  --url https://api.voiceaiwrapper.app/api/v2/clients/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_users": [
    {
      "email": "user@client.com",
      "password": "SecureP@ss123"
    }
  ],
  "client_details": {
    "name": "Acme Corp",
    "email": "acme@example.com"
  },
  "client_asset_group": {
    "tenant_voice_provider_id": "VGVuYW50Vm9pY2VQcm92aWRlcjoxMjM=",
    "name": "Default Group"
  },
  "billing_provider": {
    "type": "STRIPE",
    "selected_product": {
      "product_id": "...",
      "price_ids": [
        "..."
      ]
    }
  },
  "client_access": {
    "assistant": "view_only",
    "campaign": "view_and_add"
  },
  "assigned_resources": {
    "assistant": [
      "asst_abc123"
    ],
    "vapi_workflow": [],
    "vapi_squad": [],
    "phone_number": [],
    "phone_number_pool": [],
    "knowledge_base": [],
    "tools_and_functions": [],
    "campaign": [
      "Vm9pY2VDYW1wYWlnbjoxMjM="
    ]
  }
}
'
{
  "success": true,
  "message": "Client created successfully",
  "data": {
    "client_id": "<string>",
    "client_name": "<string>",
    "primary_email": "<string>",
    "users": [
      {}
    ],
    "asset_group_id": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Client account configuration

​
client_users
object[]
required

List of user accounts to create for this client. Required. At least one user must be provided.

​
client_details
object
required

Basic client account details. Optional.

​
client_asset_group
object
required

Client account configuration. Required. tenant_voice_provider_id is required.

​
billing_provider
object

Billing configuration. Optional. Defaults to empty if not provided.

Example:
{
  "type": "STRIPE",
  "selected_product": { "product_id": "...", "price_ids": ["..."] }
}
​
client_access
object

Dashboard permission settings. Optional. All fields optional — omitted fields use defaults. See endpoint description for full list of allowed values per field.

Example:
{
  "assistant": "view_only",
  "campaign": "view_and_add"
}
​
assigned_resources
object

Resources to assign to the client's client account configuration. Optional.

Response

Client created successfully. Returns client ID, name, email, user list, and client account configuration ID.

​
success
boolean
Example:

true

​
message
string
Example:

"Client created successfully"

​
data
object