Using this API, you can view, find, add, edit, merge, and delete contacts in a project.
...
| Code Block |
|---|
GET https://api.smartsender.com/v1/contacts |
Main parameters:
Name | Description | Validation |
|---|---|---|
page | Requested Page | Minimum value 1 |
limitation | Amount of data to display per page | Minimum value 1, maximum 20 |
In case of a successful response, you will receive the following:
...
| Code Block |
|---|
{
"cursor": Cursor,
"collection": Contact[]
}
|
Answer description:
Search.
Allows you to find matches for contacts using a keyword.
...
| Code Block |
|---|
GET https://api.smartsender.com/v1/contacts/search |
Main parameters:
Name | Description | Validation |
|---|---|---|
page | Requested Page | Minimum value 1 |
limitation | Amount of data to display per page | Minimum value 1, maximum 20 |
term | Search keyword | not empty |
In case of a successful response, you will receive the following:
...
| Code Block |
|---|
{
"cursor": Cursor,
"collection": Contact[]
}
|
Answer description:
Search by ID.
Getting information about a contact by ID.
...
| Code Block |
|---|
GET https://api.smartsender.com/v1/contacts/{contactId}/gates |
Main parameters:
Name | Description | Validation |
|---|---|---|
page | Requested Page | Minimum value 1 |
limitation | Amount of data to display per page | Minimum value 1, maximum 20 |
In case of a successful response, you will receive the following:
...
| Code Block |
|---|
{
"cursor": Cursor,
"collection": Gate[]
}
|
Answer description:
Update.
Updates the data of the selected client.
...
Basic Parameters: Specify all required parameters for the update in the request body. It can be both variables and system fields.
Main parameters:
Name | Type | Description |
|---|---|---|
values | Object (key-value) | All necessary parameters for updating in the body of the request. It can be both variables and system fields. |
Important! If an invalid value is specified for a field update, the field will be skipped and the rest of the update will be processed.
In case of a successful response, you will receive the following:
...
| Code Block |
|---|
POST https://api.smartsender.com/v1/contacts/{contactId}/fire |
Main parameters:
Name | Description |
|---|---|
name | Event name, case sensitive |
In case of a successful response, you will receive the following:
...
| Code Block |
|---|
{
"state": true
}
|
(DEPRECATED) Delete
Allows you to delete the selected contact.
...
| Code Block |
|---|
{
"state": true
}
|
Creation.
Contact creation is only available for the Smart Messenger platform using the Channels API (gateway creation). To do this you need a channel ID.