Create client
curl --request POST \
--url https://woes.dev/api/v1/clients \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company": "Example API Co"
}
'const url = 'https://woes.dev/api/v1/clients';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({company: 'Example API Co'})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://woes.dev/api/v1/clients"
payload = { "company": "Example API Co" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({company: 'Example API Co'})
};
fetch('https://woes.dev/api/v1/clients', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"client": {
"object": "<string>",
"id": "<string>",
"name": "<string>",
"healthScore": {
"score": 50,
"activity": 50,
"conversations": 50,
"resolutions": 50,
"reasons": [
"<string>"
]
},
"metrics": {
"conversations": 1,
"openConversations": 1,
"messages": 1,
"verifiedContacts": 1,
"visits": 1
},
"channels": [
{
"channel": "<string>",
"count": 1
}
],
"contacts": [
{
"id": "<string>",
"name": "<string>",
"email": "jsmith@example.com",
"identitySource": "<string>",
"lastMessageAt": "2023-11-07T05:31:56Z",
"online": true,
"visits": 1
}
],
"recentConversations": [
{
"id": "<string>",
"channel": "<string>",
"subject": "<string>",
"preview": "<string>",
"lastMessageAt": "2023-11-07T05:31:56Z"
}
],
"tasks": [
{
"id": "<string>",
"subject": "<string>",
"preview": "<string>",
"priority": "<string>",
"lastMessageAt": "2023-11-07T05:31:56Z"
}
],
"firstContactAt": "2023-11-07T05:31:56Z",
"lastMessageAt": "2023-11-07T05:31:56Z",
"latestConversationId": "<string>"
},
"truncated": true
}{
"code": "invalid_request",
"error": "Request body is invalid."
}{
"code": "unauthorized",
"error": "A valid workspace API key is required."
}{
"code": "insufficient_scope",
"error": "This API key is missing the required scope."
}{
"code": "rate_limited",
"error": "Too many API requests. Slow down and try again shortly."
}{
"code": "internal_error",
"error": "The API request could not be completed."
}Create client
Creates a manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.
POST
https://woes.dev
/
api
/
v1
/
clients
Create client
curl --request POST \
--url https://woes.dev/api/v1/clients \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company": "Example API Co"
}
'const url = 'https://woes.dev/api/v1/clients';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({company: 'Example API Co'})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://woes.dev/api/v1/clients"
payload = { "company": "Example API Co" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({company: 'Example API Co'})
};
fetch('https://woes.dev/api/v1/clients', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"client": {
"object": "<string>",
"id": "<string>",
"name": "<string>",
"healthScore": {
"score": 50,
"activity": 50,
"conversations": 50,
"resolutions": 50,
"reasons": [
"<string>"
]
},
"metrics": {
"conversations": 1,
"openConversations": 1,
"messages": 1,
"verifiedContacts": 1,
"visits": 1
},
"channels": [
{
"channel": "<string>",
"count": 1
}
],
"contacts": [
{
"id": "<string>",
"name": "<string>",
"email": "jsmith@example.com",
"identitySource": "<string>",
"lastMessageAt": "2023-11-07T05:31:56Z",
"online": true,
"visits": 1
}
],
"recentConversations": [
{
"id": "<string>",
"channel": "<string>",
"subject": "<string>",
"preview": "<string>",
"lastMessageAt": "2023-11-07T05:31:56Z"
}
],
"tasks": [
{
"id": "<string>",
"subject": "<string>",
"preview": "<string>",
"priority": "<string>",
"lastMessageAt": "2023-11-07T05:31:56Z"
}
],
"firstContactAt": "2023-11-07T05:31:56Z",
"lastMessageAt": "2023-11-07T05:31:56Z",
"latestConversationId": "<string>"
},
"truncated": true
}{
"code": "invalid_request",
"error": "Request body is invalid."
}{
"code": "unauthorized",
"error": "A valid workspace API key is required."
}{
"code": "insufficient_scope",
"error": "This API key is missing the required scope."
}{
"code": "rate_limited",
"error": "Too many API requests. Slow down and try again shortly."
}{
"code": "internal_error",
"error": "The API request could not be completed."
}Authorizations
Workspace API key that starts with woesk_. Paste your own key into the docs playground; never expose it in browser code.
Body
application/json
Response
Client seed created.
Hide child attributes
Hide child attributes
Allowed value:
"client"Available options:
attention, healthy, watch Hide child attributes
Hide child attributes
Available options:
attention, healthy, watch Required range:
0 <= x <= 100Required range:
0 <= x <= 100Required range:
0 <= x <= 100Required range:
0 <= x <= 100Hide child attributes
Hide child attributes
Required range:
x >= 0Required range:
x >= 0Required range:
x >= 0Required range:
x >= 0Required range:
x >= 0Hide child attributes
Hide child attributes
Required range:
x >= 0Hide child attributes
Hide child attributes
Available options:
open, waiting, solved Last modified on July 4, 2026
Was this page helpful?
⌘I
