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

# Create a contact

`POST /contacts`

Create a contact. When payload is an array you will get an array back, if just an object or an array with 1 item you get an object back.

## Query parameters

- `force` boolean

## Request body

- object[]
  - `owner` number — The ID of the user who owns the contact.
  - `domain` string — The contact domain.
  - `email` string — The contact email address.
  - `prefix` string — The contact name prefix.
  - `firstname` string — The contact first name.
  - `middle` string — The contact middle name.
  - `lastname` string — The contact last name.
  - `suffix` string — The contact name suffix.
  - `name` string — The full name of the contact.
  - `picture` string — The profile picture URL of the contact.
  - `account` number — The Salesflare ID of the account to link to this contact. If you explicitly pass `null`, any existing linked account is removed.
  - `birth_date` string, date-time — The contact birth date (ISO 8601 date-time).
  - `opt-out` boolean — Whether the contact has opted out of communications.
  - `opt-out_date` string, date-time — The date and time the contact opted out of communications (ISO 8601 date-time).
  - `opt-out_campaign` string
  - `bounced` boolean — Whether emails to this contact have bounced.
  - `bounced_date` string, date-time — The date and time emails to this contact bounced (ISO 8601 date-time).
  - `files` object[] — List of files associated with the contact.
  - `tags` string[] — List of tags associated with the contact.
  - `address` object — The primary address of the contact.
    - `city` string
    - `country` string
    - `region` string — Deprecated. Use `state_region` instead.
    - `state_region` string
    - `street` string
    - `type` string
    - `zip` string
  - `addresses` object[] — List of addresses associated with the contact.
    - `city` string
    - `country` string
    - `region` string — Deprecated. Use `state_region` instead.
    - `state_region` string
    - `street` string
    - `type` string
    - `zip` string
  - `phone_number` string — The primary phone number of the contact.
  - `mobile_phone_number` string — The mobile phone number of the contact.
  - `home_phone_number` string — The home phone number of the contact.
  - `fax_number` string — The fax number of the contact.
  - `phone_numbers` object[] — List of phone numbers associated with the contact.
    - `number` string, required
    - `type` string
  - `position` object — The primary position of the contact.
    - `organisation` string
    - `role` string
  - `positions` object[] — List of positions associated with the contact.
    - `end_date` string, date-time
    - `start_date` string, date-time
    - `current` boolean
    - `primary` boolean
    - `organisation` string
    - `role` string
  - `social_profiles` string[] — List of social profiles associated with the contact.
  - `custom` object — Custom field values associated with the contact.

## Response `200`

Successful

---

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