curl https://zeplo.ai/api/contacts/5 \
-H "Cookie: connect.sid=s%3A7HImZ-T2BxWSbUsf9dtWdOlBW4rVuORO.5J0Do0NyvBu%2BkTvu1aHvtNs00BKhkpUKTwiokLS0cpw"
{
"success": true,
"data": {
"id": 5,
"name": "John Doe",
"phone": "919876543210",
"email": "john@example.com",
"avatar": null,
"tags": ["vip", "customer"],
"groups": [
{ "id": 1, "name": "Customers" },
{ "id": 3, "name": "VIP" }
],
"metadata": {
"company": "Acme Inc"
},
"lastMessageAt": "2026-01-15T10:30:00Z",
"conversationCount": 3,
"messageCount": 42,
"createdAt": "2026-01-01T08:00:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
}
}
Contacts
GET Get Contact
Retrieve a single contact by ID.
GET
/
api
/
contacts
/
:id
curl https://zeplo.ai/api/contacts/5 \
-H "Cookie: connect.sid=s%3A7HImZ-T2BxWSbUsf9dtWdOlBW4rVuORO.5J0Do0NyvBu%2BkTvu1aHvtNs00BKhkpUKTwiokLS0cpw"
{
"success": true,
"data": {
"id": 5,
"name": "John Doe",
"phone": "919876543210",
"email": "john@example.com",
"avatar": null,
"tags": ["vip", "customer"],
"groups": [
{ "id": 1, "name": "Customers" },
{ "id": 3, "name": "VIP" }
],
"metadata": {
"company": "Acme Inc"
},
"lastMessageAt": "2026-01-15T10:30:00Z",
"conversationCount": 3,
"messageCount": 42,
"createdAt": "2026-01-01T08:00:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
}
}
Get Contact
GET /api/contacts/:id
Retrieve details for a specific contact.
Headers
string
required
Session cookie (login via POST /api/auth/login)
curl https://zeplo.ai/api/contacts/5 \
-H "Cookie: connect.sid=s%3A7HImZ-T2BxWSbUsf9dtWdOlBW4rVuORO.5J0Do0NyvBu%2BkTvu1aHvtNs00BKhkpUKTwiokLS0cpw"
Path parameters
integer
required
Contact ID.
{
"success": true,
"data": {
"id": 5,
"name": "John Doe",
"phone": "919876543210",
"email": "john@example.com",
"avatar": null,
"tags": ["vip", "customer"],
"groups": [
{ "id": 1, "name": "Customers" },
{ "id": 3, "name": "VIP" }
],
"metadata": {
"company": "Acme Inc"
},
"lastMessageAt": "2026-01-15T10:30:00Z",
"conversationCount": 3,
"messageCount": 42,
"createdAt": "2026-01-01T08:00:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
}
}
Contact object
| Field | Type | Description |
|---|---|---|
id | integer | Unique contact ID |
name | string | Contact display name |
phone | string | Phone with country code |
email | string|null | Email address |
avatar | string|null | Avatar URL |
tags | string[] | Contact tags |
groups | object[] | Groups the contact belongs to |
metadata | object | Custom metadata |
lastMessageAt | string|null | Last message timestamp |
conversationCount | integer | Total conversations |
messageCount | integer | Total messages |
createdAt | string | ISO 8601 timestamp |
updatedAt | string | ISO 8601 timestamp |
