v1

latestOpenAPI 3.1.12026-07-17111158225.7 KB

contacts

Update a contact

Updates the contact details.

patch/{account}/contacts/{contact}

Path parameters

accountinteger required

The account id

contactinteger required

The contact id

Request body

labelstring

first_namestring

last_namestring

address1string

address2string nullable

citystring

state_provincestring

postal_codestring

countrystring

emailstring

phonestring

faxstring nullable

organization_namestring

The company name. If the organization_name is specified, then you must also include job_title.

job_titlestring

The contact's job title. Required if the organization_name is specified.

Example request

{
  "label": "Default",
  "first_name": "First",
  "last_name": "User",
  "job_title": "CEO",
  "organization_name": "Awesome Company",
  "email": "first@example.com",
  "phone": "+18001234567",
  "fax": "+18011234567",
  "address1": "Italian Street, 10",
  "city": "Roma",
  "state_province": "RM",
  "postal_code": "00100",
  "country": "IT"
}

Response

Successfully updated contact.

Example response

{
  "data": {
    "id": 1,
    "account_id": 1010,
    "label": "Default",
    "first_name": "First",
    "last_name": "User",
    "organization_name": "Awesome Company",
    "job_title": "CEO",
    "address1": "Italian Street, 10",
    "address2": "",
    "city": "Roma",
    "state_province": "RM",
    "postal_code": "00100",
    "country": "IT",
    "phone": "+1.8001234567",
    "fax": "+1.8011234567",
    "email": "first@example.com",
    "created_at": "2013-11-08T17:23:15Z",
    "updated_at": "2015-01-08T21:30:50Z"
  }
}