Skip to main content
POST
/
api
/
v1
/
client
/
save
curl -X POST "https://server.smartlead.ai/api/v1/client/save?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "admin@acme.com",
    "name": "Acme Agency",
    "permission": ["campaigns", "email_accounts", "leads"],
    "is_credit_assigned": true,
    "email_credits": 10000,
    "lead_credits": 5000
  }'

{
  "ok": true,
  "data": {
    "id": 301,
    "name": "Acme Agency",
    "email": "admin@acme.com",
    "api_key": "cl_xxxxxxxxxxxxxxxx",
    "created_at": "2025-12-01T10:00:00.000Z"
  }
}
Create client sub-accounts to manage multiple brands or agencies from a single SmartLead account. Each client gets their own isolated workspace with configurable permissions.

​
Overview

Creates a new client sub-account under your main SmartLead account. Clients are whitelabel sub-accounts that allow agencies to manage multiple brands with isolated data and configurable permissions.

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
email
string
required
Client email address. Must be unique across the platform.
​
name
string
required
Client display name (company or brand name)
​
password
string
Login password for the client. If not provided, the client will need to set one.
Base64 encoded logo image for whitelabel branding
​
logo_url
string
URL to the client logo image for whitelabel branding
​
permission
array
Array of permission strings defining what the client can access. Controls feature visibility and access.
​
is_credit_assigned
boolean
Whether email/lead credits are specifically assigned to this client
​
email_credits
number
Number of email credits allocated to this client (when is_credit_assigned is true)
​
lead_credits
number
Number of lead credits allocated to this client (when is_credit_assigned is true)
curl -X POST "https://server.smartlead.ai/api/v1/client/save?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "admin@acme.com",
    "name": "Acme Agency",
    "permission": ["campaigns", "email_accounts", "leads"],
    "is_credit_assigned": true,
    "email_credits": 10000,
    "lead_credits": 5000
  }'

​
Response Codes

​
200
Success
Request successful
​
400
Bad Request
Invalid request parameters or malformed request body
​
401
Unauthorized
Invalid or missing API key
​
422
Validation Error
Request validation failed. Check parameter types and constraints.
{
  "ok": true,
  "data": {
    "id": 301,
    "name": "Acme Agency",
    "email": "admin@acme.com",
    "api_key": "cl_xxxxxxxxxxxxxxxx",
    "created_at": "2025-12-01T10:00:00.000Z"
  }
}