---
title: "Create a contact"
method: POST
path: "/v2/contacts"
---

# Create a contact

`POST /v2/contacts`

## Request

- Base URL: `https://api.corporatemerch.com`
- URL: `https://api.corporatemerch.com/v2/contacts`
- Auth: API key in header `Authorization`

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

## Request body

- object
  - `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
  - `email` 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` string, 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` string, date: The date the contact joined the organization or project.
  - `company_name` string: The name of the organization the contact belongs to.
  - `wedding_anniversary` string, 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.

## Response `201`

201

- object
  - `data` object
    - `id` integer
    - `contact_type` string
    - `first_name` string
    - `last_name` string
    - `phone` string
    - `email` string
    - `address1` string
    - `address2` string
    - `country` string
    - `city` string
    - `state` string
    - `zip_code` string
    - `company` string
    - `status` string
    - `tags` unknown
    - `created_at` string
    - `size` string
    - `gender` string
    - `department` string
    - `title` unknown
    - `birthday_date` string
    - `start_date` string
    - `anniversary` unknown
    - `client_since` unknown
    - `contact_classification` unknown
    - `provider` unknown
    - `item_external_id` unknown
    - `address_verified` boolean
    - `address_validated` boolean
    - `address_forced` boolean

## Other responses

- `422`: 422

---

[API](https://skmtc.dev/corporatemerch/apis/corporate-merch.md) - [All operations](https://skmtc.dev/corporatemerch/apis/corporate-merch/llms.txt) - [OpenAPI document](https://skmtc.dev/corporatemerch/apis/corporate-merch/revisions/1739fae86fb3?raw)
