---
title: "Creates a contact"
method: POST
path: "/contacts"
tags: ["Contacts"]
---

# Creates a contact

`POST /contacts`

## Request body

- Contact — Request body for POST /contacts. This is a write payload, not a response shape — responses use ContactSummary or ContactExtended.
  - `contact` object
    - `first_name` string
    - `last_name` string
    - `tag_list` string[]
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `contact_emails_attributes` object[]
      - `email` string
      - `primary` boolean
    - `contact_phones_attributes` object[]
      - `phone_number` string
      - `country_code` string
      - `primary` boolean

## Response `200`

Successful operation

- object
  - `data` ContactExtended
    - `id` integer
    - `first_name` string
    - `last_name` string
    - `nick_name` string
    - `company` string
    - `job_title` string
    - `client_id_number` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `tags` Tag[]
      - `id` integer
      - `name` string
    - `contact_emails` ContactEmail[]
      - `id` integer
      - `email` string
      - `primary` boolean
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `contact_phones` ContactPhone[]
      - `id` integer
      - `phone_number` string
      - `country_code` string
      - `country_phone_code` string
      - `phone_type` 'mobile' | 'home' | 'work' | 'fax' | 'office' | 'other'
      - `primary` boolean
      - `metadata` object
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `contact_addresses` ContactAddress[]
      - `id` integer
      - `street_address` string
      - `city` string
      - `state` string
      - `zip` string
      - `primary` boolean
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `entity_origins` Entity[]
      - `id` integer
      - `client_id_number` string
      - `name` string
      - `entity_type` string
      - `metadata` object — Additional metadata for the entity, contents may vary
      - `ein` string — Employer Identification Number (EIN)
      - `other_ids` object — Other identifying information, contents may vary
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `403` — Contact already exists
- `500` — Internal Server Error

---

[API](https://skmtc.net/gettruss/apis/api-v1.md) · [All operations](https://skmtc.net/gettruss/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettruss/api-v1/versions/7c956b3d1bdf/schema)