Skip to main content
POST
Upsert Contact

Headers

Accept
string
default:application/json

e.g. application/json

x-api-key
string

e.g. [Required] Partner specific API key provided by Birdeye for data exchange.

x-business-number
string

e.g. [Required] User assosiated businessNumber

Content-Type
string
default:application/json

Media type of the JSON request body.

Body

application/json
id
string

Id of enterprise customer.

firstName
string

First name of the customer.

lastName
string

Last name of the customer.

email
string

Email of customer, optional (if phone is provided).

phone
string

Phone of customer optional (if email is provided).

countryCode
string

Country code of the phone number. Default value=US, Other Possible values=AU,CA,MX,PR,VI

smsOptin
boolean

SMS Opt flag.

blocked
boolean

Contact block flag.

businessIds
any[]

Business Ids under enterprise account. The Business Ids field is mandatory while creating a new contact. While updating, if no business Ids are provided, the same location mappings are retained.

tags
any[]

List of tags

customFields
object[]

List of Custom fields. We currently support 4 types of customfields - text, number, currency, date (in formats - “MM/dd/yyyy” and "MM-dd-yyyy" only), and yes or no (1:"yes", 0:"no").

externalId
string

Unique external identifier of the contact which could be from the CRM or any external system storing your contacts.

emailPreferences
object

Email communication preference flags.

smsPreferences
object

SMS communication preference flags.

Response

OK

id
number

Id of enterprise customer.