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

# Create or update a contact

`POST /api/v1/contacts`

## Request

- Base URL: `https://api.misar.io/mail`
- URL: `https://api.misar.io/mail/api/v1/contacts`
- Auth: HTTP bearer

## Request body

- CreateContactRequest
  - `email` string, email, required
  - `firstName` string
  - `lastName` string
  - `phone` string
  - `tags` string[]
  - `customFields` object

## Response `201`

Contact created

- object
  - `success` boolean
  - `data` Contact
    - `id` string, uuid
    - `email` string, email
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `status` 'subscribed' | 'unsubscribed' | 'bounced' | 'complained'
    - `tags` string[]
    - `created_at` string, date-time

---

[API](https://skmtc.dev/misar/apis/misarmail-api.md) · [All operations](https://skmtc.dev/misar/apis/misarmail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/misar/apis/misarmail-api/revisions/1141238bc092?raw)