---
title: "Create a new contact"
method: POST
path: "/contact/"
tags: ["contacts"]
---

# Create a new contact

`POST /contact/`

Contacts belong to exactly one Lead (specified by `lead_id`). If you do not provide a `lead_id` then a new lead will be created, named after the contact.

Custom field values can be set by including `custom.cf_*` keys in the request body, e.g. `"custom.cf_abc123": "value"`.

## Query parameters

- `_fields` string

## Request body

- CreateContact
  - `created_by` string, nullable
  - `date_created` string, date-time, nullable
  - `emails` object[], nullable
    - `email` string, email, required
    - `type` string
  - `lead_id` string, nullable
  - `name` string, nullable
  - `phones` object[], nullable
    - `phone` string, nullable — Phone number in E.164 format
    - `type` string
  - `timezone` string, nullable — IANA timezone identifier
  - `title` string, nullable
  - `urls` object[], nullable
    - `type` string
    - `url` string, uri, required

## Response `200`

Successful response

- Contact
  - `created_by` string, nullable, required
  - `date_created` string, date-time, required
  - `date_updated` string, date-time, required
  - `display_name` string, required
  - `emails` ContactEmail[]
    - `email` string, required
    - `is_unsubscribed` boolean, required
    - `type` string, required
  - `id` string, required
  - `integration_links` RenderedIntegrationLink[]
    - `name` string, required
    - `url` string, required
  - `lead_id` string, nullable
  - `lead_suggestions_operation_id` string, nullable
  - `name` string, nullable, required
  - `organization_id` string, required
  - `phones` ContactPhone[]
    - `country` string, nullable
    - `outbound_sms_blocked` boolean
    - `phone` string, required
    - `phone_formatted` string
    - `type` string, required
    - `tz_ids` string[]
  - `recent_calls` ContactRecentCall[]
    - `dialer_id` string, nullable, required
    - `duration` integer, required
    - `finish_timestamp` string, date-time, required
    - `id` string, required
    - `status` 'created' | 'in-progress' | 'completed' | 'cancel' | 'no-answer' | 'busy' | 'failed' | 'timeout', required — Current status of the call.
  - `subscriptions` BasicSubscriptionInfoForContact[]
    - `contact_email` string, nullable, required
    - `date_created` string, date-time, required
    - `initial_email_id` string, nullable, required
    - `sequence_id` string, required
    - `sequence_name` string, required
    - `sequence_status` 'active' | 'paused' | 'draft', required
    - `start_date` string, date-time, nullable, required
    - `subscription_id` string, required
    - `subscription_status` 'active' | 'paused' | 'finished' | 'goal' | 'error', required
    - `subscription_status_reason` 'manual' | 'pending-call-timed-out' | 'bulk-action' | 'rate-limited' | 'sequence-deleted' | 'workflow-paused' | 'filter-not-matched' | 'insufficient-ai-credit-balance' | 'reply-received' | 'call-answered' | 'meeting-booked' | 'lead-status-changed' | 'outcome-met' | 'account-invalid' | 'account-failures' | 'sending-throttled-too-long' | 'membership-inactive' | 'send-as-error' | 'email-bounced' | 'call-failed' | 'sms-failed' | 'no-user-phone' | 'billing-error' | 'assignment-field-invalid' | 'lead-status-field-invalid' | 'assignees-missing' | 'run-as-disabled' | 'lead-not-visible' | 'internal-error' | 'field-mapping-error' | 'filter-config-invalid' | 'email-ai-generation-failed', required — Reason for each higher level status on a Workflow run.
  - `timezone` string, nullable
  - `timezone_source` string, nullable
  - `title` string, nullable, required
  - `updated_by` string, nullable, required
  - `urls` ContactUrl[]
    - `type` string, required
    - `url` string, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)