---
title: "Create Contact"
method: POST
path: "/contacts"
tags: ["contacts"]
---

# Create Contact

`POST /contacts`

Use this endpoint to create a new contact.

This endpoint is rate limited. Use the `RateLimit-*` response headers to check current limits and remaining quota.

## Request body

- ContactPost
  - `contactTypeIds` string[]
  - `firstName` string — First name of the contact.
  - `lastName` string — Last name of the contact.
  - `crossReference` string — CrossReference of the contact.
  - `companyName` string — Company name of the contact.
  - `companyJobTitle` string — Job title of the contact.
  - `note` string — A note for the contact.
  - `phoneNumbers` ContactPhoneNumber[]
    - `number` string, required — 10 digit phone number.
    - `ext` string — Phone extension. Used for routing calls to a specific department or individual within the organization.
    - `primary` boolean — Indicates if it's the primary phone number
    - `hasTextingAvailable` boolean — Indicates whether SMS/text messaging is enabled for this phone number. When true, the contact can receive text messages at this number.
    - `type` 'Home' | 'Mobile' | 'Work', required
  - `emailAddresses` ContactEmailAddress[]
    - `address` string, email — Contact email address
    - `primary` boolean — Indicates if it is the primary email address
    - `type` 'Personal' | 'Work' | 'Other' — The type of email
  - `mailingAddress` ContactAddress
    - `street1` string
    - `street2` string
    - `city` string
    - `zipCode` string
    - `state` ContactState
      - `id` integer — The id for the state.
    - `country` ContactCountry
      - `id` integer — The id for the Country.
  - `billingAddress` ContactAddress
    - `street1` string
    - `street2` string
    - `city` string
    - `zipCode` string
    - `state` ContactState
      - `id` integer — The id for the state.
    - `country` ContactCountry
      - `id` integer — The id for the Country.
  - `billingAddressSameAsMailingAddress` boolean — Indicates if the billing address is the same as mailing address

## Response `201`

Created

- ContactLink
  - `id` string, uuid
  - `_link` string, uri

## Other responses

- `400` — Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401` — Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `429` — Too Many Requests

---

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