---
title: "Create multiple contacts"
method: POST
path: "/customerbase/v1/contacts/bulk"
tags: ["CustomerBASE API"]
---

# Create multiple contacts

`POST /customerbase/v1/contacts/bulk`

Creates multiple contacts from JSON input

## Request body

- CustomerbaseContactRecord[]
  - `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

## Response `201`

All contacts created successfully

- CustomerbaseBulkResponse — Response structure for bulk operations with single error detail
  - `details` CustomerbaseBulkErrorDetails — Error details for failed operations in bulk processing
    - `description` string — Description of the error example: invalid email format
    - `value` string — The value that caused the error example: invalid@email..com
  - `requestId` string
  - `status` string — Status indicates the result of the operation ("success" or "error")
  - `summary` CustomerbaseBulkSummary — Summary statistics for bulk operations
    - `failed` integer — Number of failed records example: 5
    - `success` integer — Number of successfully processed records example: 95
    - `total` integer — Total number of records processed example: 100

## Other responses

- `207` — Contacts created with some failures
- `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/bulk/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)