Creating and updating a contact from the API can be done by posting your contact object to Supportbench.
The only difference between contact creations and updates is including a contact id within the contact object.
When creating or updating a contact, the below fields are available to you.
Name | Required | Limit | Default | Availability | Summary |
---|---|---|---|---|---|
id_prefix | no | 5 characters | "CT" | New | The prefix of the company. You can assign new contact prefix's within the API administration section. |
id_source | no | 25 characters | New | The source id of the contact. You can assign custom ID's from existing systems or assign your own id. | |
id | no - when creating | 30 characters | Update | The full company id including the prefix. | |
company_id | no | 30 characters | New / Update | The company id to assign to this company. | |
first_name | yes | 250 characters | New / Update | The contact's first name. | |
last_name | yes | 250 characters | New / Update | The contact's last name. | |
title | no | 100 characters | New / Update | The job title of the contact. | |
address | no | 250 characters | New / Update | The mailing address of the company. | |
city | no | 100 characters | New / Update | The mailing city of the company. | |
zip | no | 25 characters | New / Update | The mailing zip / postal code of the company. | |
state | no | 50 characters | New / Update | The mailing state or province of the company. | |
country | no | 5 characters | New / Update | The 2 character ISO country code of the company. i.e. US, CA. Country code can be found here: https://countrycode.org/ | |
no | 500 characters | New / Update | The primary email address of the user. | ||
phone | no | 50 characters | New / Update | The primary phone number of the contact. | |
phone_ext | no | 50 characters | New / Update | The extension of the primary phone number of the contact. | |
mobile | no | 10 characters | New / Update | The primary mobile / cell number of the contact. | |
active | no | Boolean | New / Update | Is the company active or not. | |
fields | no | See field object | New / Update | A field array of custom fields to insert or update. Please see the field object below. |
Field Object
Name | Required | Limit | Default | Summary |
---|---|---|---|---|
id | yes | Integer | The field id of the field you wish to update. The field id must map to a valid field in the contact. | |
value | yes | Dropdown list - Integer | The value of the custom field. The value is dependent on the field type. |