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 Enum: |
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) |