---
title: "Create a new contact"
method: POST
path: "/customerbase/v1/contacts"
tags: ["CustomerBASE API"]
---

# Create a new contact

`POST /customerbase/v1/contacts`

Creates a contact from either JSON or CSV upload

## Response `200`

Successfully created single contact

- CustomerbaseSingleContactResponse — Response structure for single contact operations
  - `contact` CustomerbaseContactRecord — Request to create a contact
    - `contactId` string — Contact's unique identifier example: contact-123
    - `email` string — Contact's email address example: john@example.com
    - `linkedinUrl` string — Contact's LinkedIn profile URL example: https://linkedin.com/in/john-doe
  - `requestId` string
  - `status` string — Status indicates the result of the operation ("success" or "error")

## Other responses

- `201` — Successfully processed CSV file
- `400` — Invalid request data
- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-07-17** `73526747b270` — 1 info
  - endpoint added
- **2024-09-10** `1ee4ed170cfa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/customeros/apis/customeros-api/changes/customerbase/v1/contacts/post.md)

---

[API](https://skmtc.dev/customeros/apis/customeros-api.md) · [All operations](https://skmtc.dev/customeros/apis/customeros-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customeros/customeros-api/revisions/73526747b270/schema)