---
title: "Create a new contact"
method: POST
path: "/customers/{customer}/contacts"
tags: ["Contacts"]
---

# Create a new contact

`POST /customers/{customer}/contacts`

Create a contact

## Path parameters

- `customer` string, required

## Headers

- `Authorization` string, required
- `sequence-version` '2024-07-30'

## Request body

- ContactRequestModel
  - `name` string, required — Full name of this contact
  - `email` string, required — Email address of this contact
  - `billingPreference` 'PRIMARY' | 'STANDARD' | 'NONE', required

## Response `201`

Created

- Contact
  - `id` string, required — Unique ID
  - `name` string, required — Full name of this contact
  - `email` string, required — Email address of this contact
  - `billingPreference` 'PRIMARY' | 'STANDARD' | 'NONE', required
  - `createdAt` string, required — Time of creation. Formatted as an ISO 8601 timestamp.
  - `updatedAt` string, required — Time of last update. Formatted as an ISO 8601 timestamp.
  - `archivedAt` string — Time of archive. Formatted as an ISO 8601 timestamp.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

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