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

# Create a contact

`POST /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

## 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.net/corporatemerch/apis/corporate-merch.md) · [All operations](https://skmtc.net/corporatemerch/apis/corporate-merch/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corporatemerch/corporate-merch/revisions/1739fae86fb3/schema)