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

# Create a contact

`POST /contacts`

## Request

- Base URL: `https://mobcrm.au/api/v1`
- URL: `https://mobcrm.au/api/v1/contacts`
- Auth: HTTP bearer

## Request body

- ContactCreate
  - `first_name` string, required
  - `middle_name` string
  - `last_name` string
  - `nickname` string
  - `maiden_name` string
  - `gender` string
  - `pronouns` string
  - `avatar_url` string
  - `birthday_mode` 'full_date' | 'month_day' | 'approximate_age'
  - `birthday_date` string
  - `birthday_month` integer
  - `birthday_day` integer
  - `birthday_year_approximate` integer
  - `status` 'active' | 'archived' | 'deceased'
  - `deceased_date` string
  - `is_favorite` boolean
  - `met_at_date` string
  - `met_at_location` string
  - `met_through_contact_id` string
  - `met_description` string
  - `job_title` string
  - `company` string
  - `industry` string
  - `work_notes` string

## Response `201`

Created contact.

- object
  - `data` Contact, required
    - `id` string
    - `first_name` string
    - `middle_name` string
    - `last_name` string
    - `nickname` string
    - `gender` string
    - `pronouns` string
    - `birthday_mode` 'full_date' | 'month_day' | 'approximate_age'
    - `birthday_date` string
    - `status` 'active' | 'archived' | 'deceased'
    - `is_favorite` boolean
    - `job_title` string
    - `company` string
    - `created_at` string
    - `updated_at` string

## Other responses

- `401`: Missing, malformed, or invalid bearer token.
- `403`: Token lacks the required scope or plan entitlement.
- `422`: Request body or query failed validation.
- `429`: Rate limit exceeded; see the Retry-After header.

---

[API](https://skmtc.dev/mobcrm/apis/mob-crm-public-api.md) · [All operations](https://skmtc.dev/mobcrm/apis/mob-crm-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mobcrm/apis/mob-crm-public-api/revisions/697e8afba2a5?raw)