curl -X POST https://kliio.app/api/v1/clients \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Alice Johnson",
"email": "alice@example.com",
"company_name": "Acme Corp"
}'
const res = await fetch('https://kliio.app/api/v1/clients', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Alice Johnson',
email: 'alice@example.com',
company_name: 'Acme Corp'
})
})
const { data } = await res.json()
{
"success": true,
"data": {
"id": "c1d2e3f4-...",
"name": "Alice Johnson",
"email": "alice@example.com",
"company_name": "Acme Corp",
"status": "invited",
"created_at": "2025-03-15T10:30:00.000Z"
}
}
{
"error": "Missing required fields: name, email"
}
{
"error": "Unauthorized: Invalid or revoked API key"
}
Clients
Create Client
Creates a new client. Triggers a client.created webhook event.
POST
/
api
/
v1
/
clients
curl -X POST https://kliio.app/api/v1/clients \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Alice Johnson",
"email": "alice@example.com",
"company_name": "Acme Corp"
}'
const res = await fetch('https://kliio.app/api/v1/clients', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Alice Johnson',
email: 'alice@example.com',
company_name: 'Acme Corp'
})
})
const { data } = await res.json()
{
"success": true,
"data": {
"id": "c1d2e3f4-...",
"name": "Alice Johnson",
"email": "alice@example.com",
"company_name": "Acme Corp",
"status": "invited",
"created_at": "2025-03-15T10:30:00.000Z"
}
}
{
"error": "Missing required fields: name, email"
}
{
"error": "Unauthorized: Invalid or revoked API key"
}
Headers
string
required
Bearer YOUR_API_KEYBody
string
required
Full name of the client contact.
string
required
Email address of the client.
string
Optional company or business name.
string
Optional phone number for the client.
Response
boolean
true on successful creation.object
curl -X POST https://kliio.app/api/v1/clients \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Alice Johnson",
"email": "alice@example.com",
"company_name": "Acme Corp"
}'
const res = await fetch('https://kliio.app/api/v1/clients', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Alice Johnson',
email: 'alice@example.com',
company_name: 'Acme Corp'
})
})
const { data } = await res.json()
{
"success": true,
"data": {
"id": "c1d2e3f4-...",
"name": "Alice Johnson",
"email": "alice@example.com",
"company_name": "Acme Corp",
"status": "invited",
"created_at": "2025-03-15T10:30:00.000Z"
}
}
{
"error": "Missing required fields: name, email"
}
{
"error": "Unauthorized: Invalid or revoked API key"
}