Create / Update Contact

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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.

NameRequiredLimitDefaultAvailabilitySummary
id_prefixno5 characters"CT"NewThe prefix of the company. You can assign new contact prefix's within the API administration section.
id_sourceno25 characters
NewThe source id of the contact. You can assign custom ID's from existing systems or assign your own id.
idno - when creating
yes - when updating
30 characters
UpdateThe full company id including the prefix.
company_idno30 characters
New / UpdateThe company id to assign to this company.
first_nameyes250 characters
New / UpdateThe contact's first name.
last_nameyes250 characters
New / UpdateThe contact's last name.
titleno100 characters
New / UpdateThe job title of the contact.
addressno250 characters
New / UpdateThe mailing address of the company.
cityno100 characters
New / UpdateThe mailing city of the company.
zipno25 characters
New / UpdateThe mailing zip / postal code of the company.
stateno50 characters
New / UpdateThe mailing state or province of the company.
countryno5 characters
New / UpdateThe 2 character ISO country code of the company. i.e. US, CA. Country code can be found here: https://countrycode.org/
emailno500 characters
New / UpdateThe primary email address of the user.
phoneno50 characters
New / UpdateThe primary phone number of the contact.
phone_extno50 characters
New / UpdateThe extension of the primary phone number of the contact.
mobileno10 characters
New / UpdateThe primary mobile / cell number of the contact.
activenoBoolean
New / UpdateIs the company active or not.
fieldsnoSee field object
New / UpdateA field array of custom fields to insert or update. Please see the field object below.

Field Object

NameRequiredLimitDefaultSummary
idyesInteger
The field id of the field you wish to update. The field id must map to a valid field in the contact.
valueyesDropdown list - Integer
Checkbox - Boolean
Text box - Unlimited
The value of the custom field. The value is dependent on the field type.
Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json