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

# Create a new contact

`POST /contacts`

## Request

- Base URL: `https://api.loopify.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.loopify.com/contacts`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.loopify.com/connect/authorize`, token URL `https://auth.loopify.com/token`, scopes: `ContactDataManagement`, `WriteContacts`, `AccountAPIKey`)

#### Auth policies: ContactDataManagement,WriteContacts,AccountAPIKey

## Request body

- ContactInsert
  - `externalId` string, nullable
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `email` string, nullable
  - `mobile` string, nullable
  - `title` string, nullable
  - `companyName` string, nullable
  - `address` string, nullable
  - `zip` string, nullable
  - `city` string, nullable
  - `country` string, nullable
  - `state` string, nullable
  - `leadScore` integer
  - `tagGroups` ContactTagGroup[], nullable
    - `tags` string[], nullable
    - `name` string, nullable
  - `customFields` ContactCustomField[], nullable
    - `source` string, nullable
    - `value` unknown

## Response `200`

Contact was successfully inserted

## Other responses

- `400`: 1: License issue, 2:Contact is missing or malformed 3: Contact already exist
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Insert failed

---

[API](https://skmtc.dev/loopify/apis/web-api-loopify.md) · [All operations](https://skmtc.dev/loopify/apis/web-api-loopify/llms.txt) · [OpenAPI document](https://skmtc.dev/loopify/apis/web-api-loopify/revisions/68c51b11a24b?raw)