Rest API endpoints for contacts
Creating Contacts
Description:
Creates a new contact and stores it in the CRM system.
Request Headers:
x-api-key: <your-api-key>
Request Method:
POST
Fields:
first_name
String
Required
First name of contact
String
Required
Email of contact
last_name
String
Last name of contact
company
String
Company that contact works at
phone
Integer
Phone number of contact
job_title
String
Job title of contact
notes
String
Notes about the contact
Request Example
{
"first_name": "John",
"last_name": "Doe",
"email": "johndoe@example.com",
"phone": "+1234567890",
"company": "Example Inc.",
"job_title": "Sales Manager",
"notes": "Interested in product demo"
}
Returns:
Status : 200
id
String
Id of the newly created contact
Response Example
{
"id": "12345678901234567890"
}
Reading Contacts
Description:
Querrys your contact list and returns matching contacts
Request Headers:
x-api-key: <your-api-key>
Request Method:
GET
Fields:
searchby
String
Required
Parameters to search by. Search must be a valid contact field.
search
String
Required
Term to search by
Request Example
{
"searchby": "company",
"search": "Example Inc."
}
Returns:
Status : 200
id
String
Id of the newly created contact
Response Example
{
"id": "12345678901234567890"
}
Editing Contacts
Description:
Edit the fields of a contact
Request Headers:
x-api-key: <your-api-key>
Request Method:
POST
Fields:
contact_id
String
Required
Id of contact to update
update_fields
Object
Required
Object that contains the properties to
update on the contact
these properties are:
name, email, phone
Request Example
{
"contactID": "12345678901234567890",
"updateFields": {
"email": "example@example.com",
"phone": 1234567890
}
}
Returns:
Status : 200
id
String
Id of the newly created contact
Response Example
{
"id": "12345678901234567890"
}
Deleting Contact
Description:
Deletes a contact from the CRM system
Request Headers:
x-api-key: <your-api-key>
Request Method:
DELETE
Fields:
contact_id
String
Required
Id of contact deal to delete
Request Example
{
"contact_id": "12345678901234567890"
}
Returns:
Status : 200
Response Body
"Document deleted successfully"
Response Example
Document deleted successfully