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

email

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: "online" "offline"

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)