Create a contact

post

https://api.corporatemerch.com/v2/contacts

Add a new contact to your account. Use this endpoint to store identity details, assign tags, and set the contact type for future filtering and management

Body Params

type

string

required

The classification of the contact (e.g., employee,, or client).

first_name

string

required

The contact's legal first name

last_name

string

required

The contact's legal last name

string

required

A valid email address for communication and identification

phone_number

string

The contact's primary telephone number.

gender

string

The gender identity of the contact. Available values: male or female

shirt_size

string

Preferred clothing size for corporate merch or gifting. Available options: XS,SM,MD,LG,XL,2XL,3XL.

birthday

date

The contact's date of birth (Format: YYYY-MM-DD).

country

string

required

The country of residence or business operation. Only 2 digit country code with uppercase letters is allowed.

address

string

required

Street address information

unit

string

Apartment, suite, or unit number.

city

string

required

The city name for the contact's location.

state

string

required

The state, province, or region. If the country is either US or CA, then state code is applicable, otherwise state name will be used.

zip_code

string

required

The postal or zip code.

department

string

The specific internal department (e.g., "Engineering").

position

string

The contact's official job title.

employment_type

string

Status of employment (e.g., full-time, contractor).

start_date

date

The date the contact joined the organization or project.

company_name

string

The name of the organization the contact belongs to.

wedding_anniversary

date

The contact's anniversary date for personal milestones.

address_validated

boolean

Boolean flag indicating if the address has been checked against a validation service.

address_forced

boolean

Boolean flag to bypass validation errors and save the address as entered.

address_verified

boolean

Boolean flag confirming the address is accurate and deliverable.

Responses

200200

400400