Only show these results:

Transition to v2.1

Transitioning to v2.0 from 1.0 doesn't involve making any changes to your application, unless you are already using the /contacts endpoints.

For v2.0, we extended the contact model to store different and additional fields.

In v2.1 only one non-breaking change was added: support for the ical_uid field on Events. See the ical_uid changelog for details.

Contact v1.0

{
"account_id": "8m8m8m8m8m8m8m8m8m8m8m",
"email": "john.doe@gmail.com",
"id": "wcf09qo0ed7430emnnst718f",
"name": "John Doe",
"object": "contact",
"phone_numbers": [
{
"number": "415 333 4545",
"type": "Mobile"
}
]
}

Contact v2.0

{
"account_id": "8m8m8m8m8m8m8m8m8m8m8m",
"birthday": "1990-02-08",
"company_name": "Nylas",
"emails": [
{
"email": "john.doe@gmail.com",
"type": "personal"
},
{
"email": "john@doecapital.com",
"type": "work"
}
],
"given_name": "John",
"id": "wcf09qo0ed7430emnnst718f",
"im_addresses": [],
"job_title": "Software Engineer",
"manager_name": null,
"middle_name": null,
"nickname": "Doey",
"notes": "Loves ramen",
"object": "contact",
"office_location": null,
"phone_numbers": [
{
"number": "415 333 4545",
"type": "mobile"
}
],
"physical_addresses": [],
"picture_url": null,
"suffix": null,
"surname": "Doe",
"web_pages": [
{
"url": "johndoecapital.com",
"type": "work"
},
{
"url": "joeslife.com",
"type": "blog"

]
}

Breaking Changes

A few of the v1.0 fields were changed to include more data.

v1.0 v2.0
name 3 fields: given_name,middle_name,surname
email A list of Email Address objects which allows storing multiple emails per contact

Transitioning to v2.0 is only needed if you reference the .name or .email attributes for contacts. To get a full name for v2.0, you can concatenate the three name fields. There are possibly multiple emails per contact, so transitioning to v2.0 will require adding more logic around what email to return.

New Functionality

Contacts v2.0 has many more fields as shown in the contact model. Additionally, there is support for create, update, delete and get contact pictures.