Sign in

v1

latestOpenAPI 3.1.02026-08-061,5107704.5 MB
Contact

Contacts.update

Modifies Contact or Contacts with given id(s)

patch/entities/Contacts/{id}

Path parameters

idstring uuid required

ID of Contact to update

Query parameters

validation-levelinteger

Specify validation level of Contact on update. Use them as bit mask: 0 - validate each field on entity, 2 - validate only changed fields, 4 - validate only system fields, 8 - allows to override readonly fields, 16 - allows to set entity on deleted relationship.

Request body

createdstring date-time

Creation time.

addressstring

Street address of the contact.

citystring

City of the contact address.

commentsstring

Free-form notes describing the contact.

contact_type_idstring uuid

Id of the contact type assigned to this contact.

countrystring

Country of the contact address.

currency_exchange_rates_list_idstring uuid

Id of the currency exchange rate list applied to this contact.

email1string

Primary email address of the contact. Used as default recipient for emails sent from Coevera.

email2string

Additional email address.

email3string

Additional email address.

email4string

Additional email address.

email5string

Additional email address.

first_namestring

Given name of the contact.

gender0 | 1 | 2 | 3

Gender of the contact (e.g. Male, Female, Other).

Integer enum value: 0 - Unknown, 1 - Male, 2 - Female, 3 - NonBinary

is_archivedboolean

True when the contact has been archived. Archived contacts remain readable but are hidden from active lists and cannot be edited until reactivated.

last_namestring

Family name of the contact.

middle_namestring

Middle name of the contact, if applicable.

owner_idstring uuid

Id of the contact owner.

phone1string

Primary phone number of the contact. Used as default target for click-to-call.

phone2string

Additional phone number.

phone3string

Additional phone number.

phone4string

Additional phone number.

phone5string

Additional phone number.

picture_idstring uuid

Id of the profile picture document.

positionstring

Job title or position of the contact.

quick_account_namestring

Free-text company name used when the contact is not linked to an actual Account record. Lets integrators capture the company without creating a separate Account.

share_mode0 | 1 | 2 | 3

Sharing model applied on top of the owner/unit visibility (e.g. shared with selected sales units or selected users). The matching sharing_units / sharing_clients lists control who is granted access.

Integer enum value: 0 - Standard, 1 - Private, 2 - AllView, 3 - AllEdit

state_provincestring

State or province of the contact address.

titlestring

Honorific or salutation prefix (e.g. Mr., Ms., Dr.) shown before the name.

unit_idstring uuid

Id of the sales unit.

zip_codestring

ZIP or postal code of the contact address.

revisioninteger

Revision when entity was lastly changed.

exchange_entity_idstring

External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.

gapi_entity_idstring

External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.

o365_entity_idstring

External identifier of the record in the linked third-party service (e.g. Google, Microsoft 365, Exchange). Maintained by the sync engine.

account_positionstring

Job position of Contact in his primary Account or quick account position if Contact has no primary Account.

is_unsubscribedboolean

If account has any unsubscribed email.

primary_account_relationshipstring

Org chart relationship of Contact in his primary Account.

Example request

{
  "created": "2019-01-01T00:00:00",
  "address": "string",
  "city": "string",
  "comments": "string",
  "contact_type_id": "01234567-abcd-dcba-ffff-000000000000",
  "country": "string",
  "currency_exchange_rates_list_id": "01234567-abcd-dcba-ffff-000000000000",
  "email1": "string",
  "email2": "string",
  "email3": "string",
  "email4": "string",
  "email5": "string",
  "first_name": "string",
  "last_name": "string",
  "middle_name": "string",
  "owner_id": "01234567-abcd-dcba-ffff-000000000000",
  "phone1": "string",
  "phone2": "string",
  "phone3": "string",
  "phone4": "string",
  "phone5": "string",
  "picture_id": "01234567-abcd-dcba-ffff-000000000000",
  "position": "string",
  "quick_account_name": "string",
  "state_province": "string",
  "title": "string",
  "unit_id": "01234567-abcd-dcba-ffff-000000000000",
  "zip_code": "string",
  "revision": 1,
  "exchange_entity_id": "string",
  "gapi_entity_id": "string",
  "o365_entity_id": "string",
  "account_position": "string",
  "primary_account_relationship": "string"
}

Response

Modification confirmation. Returns resulting Contact

successboolean

True when response succeeded, false on error.

Example response

{
  "success": true,
  "data": {
    "id": "01234567-abcd-dcba-ffff-000000000000",
    "modified": "2019-01-01T00:00:00",
    "created": "2019-01-01T00:00:00",
    "address": "string",
    "city": "string",
    "comments": "string",
    "contact_type_id": "01234567-abcd-dcba-ffff-000000000000",
    "country": "string",
    "currency_exchange_rates_list_id": "01234567-abcd-dcba-ffff-000000000000",
    "email1": "string",
    "email2": "string",
    "email3": "string",
    "email4": "string",
    "email5": "string",
    "first_name": "string",
    "last_name": "string",
    "middle_name": "string",
    "owner_id": "01234567-abcd-dcba-ffff-000000000000",
    "phone1": "string",
    "phone2": "string",
    "phone3": "string",
    "phone4": "string",
    "phone5": "string",
    "picture_id": "01234567-abcd-dcba-ffff-000000000000",
    "position": "string",
    "quick_account_name": "string",
    "state_province": "string",
    "title": "string",
    "unit_id": "01234567-abcd-dcba-ffff-000000000000",
    "zip_code": "string",
    "revision": 1,
    "formatted_name": "string",
    "exchange_entity_id": "string",
    "gapi_entity_id": "string",
    "o365_entity_id": "string",
    "primary_account_position": "string",
    "account_position": "string",
    "primary_account_relationship": "string",
    "modified_by_user": "2019-01-01T00:00:00"
  }
}