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

Authorizations

Query parameters

limitstringOptional

tagsstringOptional

locationIdstringOptional

pagestringOptional

channelstringOptional

searchTextstringOptional

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

get

HTTPcURLJavaScriptPython

GET /v1/contacts HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

[
  {
    "id": "text",
    "name": "text",
    "phoneNumber": "text",
    "location": {
      "id": "text",
      "title": "text"
    },
    "stage": "Subscriber",
    "notes": "text",
    "customFields": {},
    "tags": [
      "text"
    ]
  }
]

post

Authorizations

Header parameters

x-api-keystringRequired

Body

idstringOptional

namestringRequired

phoneNumberstringRequired

stagestring · enumOptionalPossible values:

notesstringOptional

customFieldsobjectOptional

tagsstring[]Optional

Responses

200

200 response

application/json

post

HTTPcURLJavaScriptPython

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

200 response

{
  "id": "text",
  "name": "text",
  "phoneNumber": "text",
  "location": {
    "id": "text",
    "title": "text"
  },
  "stage": "Subscriber",
  "notes": "text",
  "customFields": {},
  "tags": [
    "text"
  ]
}

get

Authorizations

Path parameters

contactIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

get

HTTPcURLJavaScriptPython

GET /v1/contacts/{contactId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

{
  "id": "text",
  "name": "text",
  "phoneNumber": "text",
  "location": {
    "id": "text",
    "title": "text"
  },
  "stage": "Subscriber",
  "notes": "text",
  "customFields": {},
  "tags": [
    "text"
  ]
}

delete

Authorizations

Path parameters

contactIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

delete

HTTPcURLJavaScriptPython

DELETE /v1/contacts/{contactId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

{
  "success": true
}

put

Authorizations

Path parameters

contactIdstringRequired

Header parameters

x-api-keystringRequired

Body

idstringOptional

namestringRequired

phoneNumberstringRequired

stagestring · enumOptionalPossible values:

notesstringOptional

customFieldsobjectOptional

tagsstring[]Optional

Responses

200

200 response

application/json

put

HTTPcURLJavaScriptPython

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

200 response

{
  "id": "text",
  "name": "text",
  "phoneNumber": "text",
  "location": {
    "id": "text",
    "title": "text"
  },
  "stage": "Subscriber",
  "notes": "text",
  "customFields": {},
  "tags": [
    "text"
  ]
}

post

Authorizations

Path parameters

proxystringRequired

contactIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

post

HTTPcURLJavaScriptPython

POST /v1/contacts/{contactId}/tags/add HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

{
  "id": "text",
  "tags": [
    "text"
  ]
}

post

Authorizations

Path parameters

proxystringRequired

contactIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

post

HTTPcURLJavaScriptPython

POST /v1/contacts/{contactId}/tags/remove HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

{
  "id": "text",
  "tags": [
    "text"
  ]
}