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 '{
    "id": 301,
    "email": "admin@acme.com",
    "name": "Acme Agency Updated",
    "email_credits": 20000
  }'

{
  "ok": true,
  "data": {
    "id": 301,
    "name": "Acme Agency Updated",
    "email": "admin@acme.com"
  }
}
To update a client, include the id field in the request body along with the fields you want to change. The same endpoint is used for both creating and updating clients.

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
id
number
required
The ID of the client to update. This makes the request an update instead of a create.
​
email
string
required
Client email address
​
name
string
required
Client display name
​
password
string
New login password for the client
Base64 encoded logo image
​
logo_url
string
URL to the client logo image
​
uuid
string
Unique identifier for the client
​
permission
array
Array of permission strings
​
is_credit_assigned
boolean
Whether credits are assigned to this client
​
email_credits
number
Email credits allocated
​
lead_credits
number
Lead credits allocated
curl -X POST "https://server.smartlead.ai/api/v1/client/save?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 301,
    "email": "admin@acme.com",
    "name": "Acme Agency Updated",
    "email_credits": 20000
  }'

​
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 Updated",
    "email": "admin@acme.com"
  }
}