Update Contact
Update a contact belonging to an account by ID.
Settings:
|
URL |
https://online.99digital.co.il/api/v1/accounts/{account_id}/contacts/{contact_id} |
|
Method |
JSON via PATCH |
Authorization:
|
Header Parameter |
Description |
|
api_access_token |
user API key |
The user API key provides access to endpoints based on the user permissions levels and can be obtained by visiting the profile page.
Path Parameters:
|
Parameter |
Description |
Required |
|
account_id |
The numeric id of the account |
yes |
|
contact_id |
The numeric id of the contact |
yes |
Request body:
|
Parameter |
type |
Description |
Required |
|
name |
string |
Name of the contact |
no |
|
|
string |
Email of the contact |
no |
|
phone_number |
string |
Phone number of the contact in e164 format. for example: +972771234567 |
no |
|
avatar_url |
string |
The url to a jpeg, png file for the contact avatar |
no |
|
identifier |
string |
A unique identifier for the contact in external system |
no |
|
custom_attributes |
string |
An object where you can store custom attributes for contact |
no |
Request body example:
{
"phone_number": "string",
}
Response:
{
"payload": {
"contact": {
"id": 0,
"name": "string",
"email": "string",
"phone_number": "string",
"availability_status": "offline",
"identifier": "string",
"thumbnail": "string",
"blocked": false,
"created_at": 0,
"custom_attributes": {
"attribute_key": "attribute_value"
},
"additional_attributes": {},
"contact_inboxes": [
{
"source_id": "string",
"inbox": {}
}
]
},
"contact_inbox": {
"inbox": {},
"source_id": "string"
}
}
}
Response-Explain:
|
Parameter |
Description |
|
payload |
Object containing the response |
|
payload -> id |
Contact numeric id |
|
payload -> name |
Full name of the contact |
|
payload -> email |
Email address of the contact |
|
payload -> phone_number |
Phone number of the contact |
|
payload -> availability_status |
Availability status of the contact
|
|
payload -> identifier |
A unique identifier for the contact in external system |
|
payload -> thumbnail |
Avatar URL of the contact |
|
payload -> blocked |
Whether the contact is blocked |
|
payload -> created_at |
Timestamp of contact creation time |
|
payload -> custom_attributes |
The object to save custom attributes for contact, accepts custom attributes key and value |
|
payload -> additional_attributes |
The object containing additional attributes related to the contact |
|
payload -> contact_inboxes |
Array of objects (contact_inboxes) |
Created with the Personal Edition of HelpNDoc: Produce electronic books easily