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

# Create contact

`POST /contacts`

Create a new contact at the company level.

Required scope: `contacts:write`

## Request body

- CreateContact
  - `name` string — Contact name
  - `description` string — Contact description
  - `avatar` string, binary — Binary data of avatar. Must use `Content-Type: multipart/form-data` if specified. See [example](https://gist.github.com/hdornier/e04d04921032e98271f46ff8a539a4cb) or read more about [Attachments](https://dev.frontapp.com/docs/attachments-1). Max 25 MB.
  - `links` string[] — List of all the links of the contact
  - `group_names` string[] — List of all the group names the contact belongs to. It will automatically create missing groups. ⚠️ Deprecated. Use `list_names` instead.
  - `list_names` string[] — List of all the contact list names the contact belongs to. It will automatically create missing groups
  - `custom_fields` CustomFieldParameter — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
  - `handles` ContactHandle[], required — List of the handles for this contact. Each handle object should include `handle` and `source` fields.
    - `handle` string, required — Handle used to reach the contact.
    - `source` 'twitter' | 'email' | 'phone' | 'facebook' | 'intercom' | 'front_chat' | 'custom', required — Source of the handle. Can be `email`, `phone`, `twitter`, `facebook`, `intercom`, `front_chat`, or `custom`.

## Response `201`

A contact

- ContactResponse
  - `_links` object
    - `self` string — Link to resource
    - `related` object
      - `notes` string — Link to contact notes
      - `conversations` string — Link to contact conversations
      - `owner` string — Link to contact owner
  - `id` string — Unique identifier of the contact
  - `name` string — Contact name
  - `description` string — Contact description
  - `avatar_url` string — URL of the contact's avatar
  - `links` string[] — List of all the links of the contact
  - `groups` ContactListResponses[] — List of the groups the contact belongs to. ⚠️ Deprecated. use `lists` instead.
    - `_links` object
      - `self` string — Link to resource
      - `related` object
        - `contacts` string — Link to contact list contacts
        - `owner` string — Link to list owner
    - `id` string — Unique identifier of the list
    - `name` string — Name of the list
    - `is_private` boolean — Whether or not the contact is individual
  - `lists` ContactListResponses[] — List of the contact lists the contact belongs to.
    - `_links` object
      - `self` string — Link to resource
      - `related` object
        - `contacts` string — Link to contact list contacts
        - `owner` string — Link to list owner
    - `id` string — Unique identifier of the list
    - `name` string — Name of the list
    - `is_private` boolean — Whether or not the contact is individual
  - `handles` ContactHandle[] — List of the handles and sources with which the contact is reachable.
    - `handle` string, required — Handle used to reach the contact.
    - `source` 'twitter' | 'email' | 'phone' | 'facebook' | 'intercom' | 'front_chat' | 'custom', required — Source of the handle. Can be `email`, `phone`, `twitter`, `facebook`, `intercom`, `front_chat`, or `custom`.
  - `custom_fields` CustomFieldParameter — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
  - `is_private` boolean — Whether or not the contact is individual

---

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