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

# Create contact

`POST /contacts`

## Request

- Base URL: `https://connect.pingback.com/v2`
- URL: `https://connect.pingback.com/v2/contacts`
- Auth: API key in header `x-api-key`

Creates a new contact.

## Headers

- `developer-mode` boolean, required
- `x-api-key` string, required

## Request body

- ContactCreate
  - `email` string, email, required
  - `origin` ContactOrigin
    - `url` string
    - `utmSource` string
    - `utmCampaign` string
    - `utmMedium` string
    - `utmTerm` string
    - `utmContent` string
  - `attributes` object

## Response `201`

Contact created

- ContactBasicResponse
  - `id` string, uuid
  - `email` string, email

## Other responses

- `400`: Request body missing or malformed
- `403`: Invalid or missing API key
- `409`: Contact conflict
- `422`: Validation error

---

[API](https://skmtc.dev/pingback/apis/pingback-connect-api.md) · [All operations](https://skmtc.dev/pingback/apis/pingback-connect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pingback/apis/pingback-connect-api/revisions/92ac3e0da8fe?raw)