Contacts
This section details endpoints dedicated to managing contacts effectively, facilitating streamlined interaction and organization within the platform.
Search Contacts: Search and retrieve contacts based on specified parameters or keywords, enabling efficient categorization and retrieval.
Add Contact: Create and add new contacts to the platform by providing the necessary contact details via this endpoint.
Get Contact By Id: Retrieve detailed information about a specific contact using its unique identifier (contactId
).
Delete Contact: Delete a specific contact from the platform, identified by its unique identifier (contactId
).
Update Contact: Modify and update contact information for a specific contact identified by its unique identifier (contactId
).
Add Tag to Contact: Associate tags with a specific contact, enhancing categorization and triggering automations.
Remove Tag from Contact: Effortlessly remove tags associated with a specific contact, facilitating flexible tag management.
GET /v1/contacts HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*
200 response
[
{
"id": "text",
"name": "text",
"phoneNumber": "text",
"location": {
"id": "text",
"title": "text"
},
"stage": "Subscriber",
"notes": "text",
"customFields": {},
"tags": [
"text"
]
}
]
POST /v1/contacts HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 158
{
"id": "text",
"name": "text",
"phoneNumber": "text",
"location": {
"id": "text",
"title": "text"
},
"stage": "Subscriber",
"notes": "text",
"customFields": {},
"tags": [
"text"
]
}
200 response
{
"id": "text",
"name": "text",
"phoneNumber": "text",
"location": {
"id": "text",
"title": "text"
},
"stage": "Subscriber",
"notes": "text",
"customFields": {},
"tags": [
"text"
]
}
GET /v1/contacts/{contactId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*
200 response
{
"id": "text",
"name": "text",
"phoneNumber": "text",
"location": {
"id": "text",
"title": "text"
},
"stage": "Subscriber",
"notes": "text",
"customFields": {},
"tags": [
"text"
]
}
DELETE /v1/contacts/{contactId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*
200 response
{
"success": true
}
PUT /v1/contacts/{contactId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 158
{
"id": "text",
"name": "text",
"phoneNumber": "text",
"location": {
"id": "text",
"title": "text"
},
"stage": "Subscriber",
"notes": "text",
"customFields": {},
"tags": [
"text"
]
}
200 response
{
"id": "text",
"name": "text",
"phoneNumber": "text",
"location": {
"id": "text",
"title": "text"
},
"stage": "Subscriber",
"notes": "text",
"customFields": {},
"tags": [
"text"
]
}
POST /v1/contacts/{contactId}/tags/add HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*
200 response
{
"id": "text",
"tags": [
"text"
]
}
POST /v1/contacts/{contactId}/tags/remove HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*
200 response
{
"id": "text",
"tags": [
"text"
]
}
Last updated