Update a contact

put

https://api.corporatemerch.com/v2/contacts/{id}

Modify an existing Contact entry by its unique identifier. Use this to sync updated user profiles, refresh address validation flags, or record changes in employment status and contact classification.

📘
Authentication
Provide your bearer token in the Authorization header.
Example: Authorization: Bearer 123

Path Params

string

required

ID of the contact

Body Params

first_name

string

required

The contact's first name.

last_name

string

required

The contact's last name.

string

required

The contact's email address. Must be a valid email format.

phone_number

string

The contact's phone number.

gender

string

The contact's gender. Allowed values: male, female.

shirt_size

string

The contact's preferred shirt size. Allowed values: XS, SM, MD, LG, XL, 2XL, 3XL.

birthday_date

date

The contact's date of birth. Format: yyyy-mm-dd (e.g., 1990-01-15).

country

string

required

The 2-letter ISO country code (e.g., US, CA, DE).

address

string

The primary street address. Required if address2 is not provided.

address2

string

The secondary address line (e.g., apartment, suite). Required if address is not provided.

city

string

required

The city name.

state

string

required

The state or province. For US: must be a valid 2-letter US state code (e.g., NY, CA, TX). For CA: must be a valid 2-letter Canadian province/territory code (e.g., ON, BC, AB). For other countries: any string value is accepted.

zip_code

string

required

The postal/zip code.

company_name

string

The name of the contact's company.

department

string

The department the contact belongs to within their organization.

position

string

The contact's job title or position.

employee_status

string

The current employment status of the contact (e.g., active, inactive).

contact_type

string

required

The type of contact. Allowed values: employee, client.

employment_type

string

The type of employment (e.g., Full-Time, Part-Time, Contract).

start_date

date

The contact's employment or engagement start date. Format: yyyy-mm-dd (e.g., 2024-01-15).

anniversary

date

The contact's wedding or work anniversary date. Format: yyyy-mm-dd (e.g., 2018-06-20).

client_since

date

The date since the contact has been a client. Format: yyyy-mm-dd (e.g., 2020-03-01).

contact_classification

string

A classification label for the contact (e.g., VIP, Regular).

address_validated

boolean

Indicates whether the address has been validated. Accepts true or false.

address_forced

boolean

Indicates whether the address was force-accepted despite validation issues. Accepts true or false.

address_verified

boolean

Indicates whether the address has been verified. Accepts true or false.

lists

array of int32s

An array of list IDs to associate the contact with. Each ID must be a valid, existing list ID.

lists

labels

array of int32s

An array of label IDs to tag the contact with. Each ID must be a valid, existing contact label ID.

labels

Responses

📘Authentication

200200

422422

📘
Authentication