---
title: "Add a new contact"
method: POST
path: "/api/v2/contacts/normalized"
tags: ["Contacts"]
---

# Add a new contact

`POST /api/v2/contacts/normalized`

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Contacts/createContact" target="_blank">Try in sandbox</a><br>

## Request body

- object
  - `firstName` string — Contact first name.
  - `lastName` string — Contact last name.
  - `phone` string, required — Phone number in [E.164 format](https://en.wikipedia.org/wiki/E.164).
  - `email` string, email — Contact email address.
  - `companyName` string — Company name.
  - `lists` string, required — Contact [list](https://docs.textmagic.com/#tag/Lists) ID. Each contact must be assigned to at least one list.
  - `favorited` boolean — Is the contact marked as favorite?
  - `blocked` boolean — Is the contact blocked for outgoing and incoming messaging?
  - `type` 0 | 1 — Force type of phone. Possible values: 0 is landline; 1 is mobile; default is -1 (auto-detection).
  - `customFieldValues` CustomFieldListItem[]
    - `id` integer, required — Custom Field ID.
    - `userCustomFieldId` integer, required — Old property custom Field ID.
    - `name` string, required — Custom Field name.
    - `value` string, required — Custom Field value.
    - `createdAt` string, date-time, required — Custom field creation time.
  - `local` 0 | 1 — Treat phone numbers passed in the request body as local.
  - `country` string — The 2-letter ISO country code for local phone numbers, used when local is set to true. Default is the account country.
  - `tags` integer[] — An array of tag IDs that will be assigned to the contact.
  - `owner` integer — Contact Owner ID

## Response `201`

Contact has been created with success.

- ResourceLinkResponse — Response contains paginated list of data items.
  - `id` integer, required — Resource ID.
  - `href` string, required — A link to this resource. If you want to fetch it, just **GET** this address.

## Other responses

- `400` — Bad request.
- `401` — Unauthorized request.

---

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