---
title: "Bulk create accounts"
method: POST
path: "/v3/contact-accounts/bulk"
tags: ["Accounts"]
---

# Bulk create accounts

`POST /v3/contact-accounts/bulk`

<small>_Requires the `contacts:write` scope (or a broader one that includes it)._</small>

Creates multiple accounts. Non-atomic — some may succeed while others fail.
Each item in the response array contains the created ID or error details.

## Request body

- object — Request body for bulk creating accounts
  - `items` object[], required — List of contact accounts to create
    - `name` string, required — Contact account name
    - `description` string, nullable — Optional description
    - `domainName` string, nullable — Primary domain name
    - `domainSecondary` string, nullable — Secondary domain name
    - `industry` string, nullable — Industry of the company
    - `companySize` 'Empty' | 'SelfEmployed' | '2-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10001+', nullable — Company size range
    - `country` string, nullable — Country of the company
    - `state` string, nullable — State or province
    - `city` string, nullable — City
    - `timeZoneId` string, nullable — Time zone identifier
    - `linkedInUrl` string, nullable — LinkedIn profile URL
    - `phone` string, nullable — Phone number
    - `twitterUrl` string, nullable — Twitter profile URL
    - `logoUrl` string, nullable — Company logo URL
    - `email` string, nullable — Contact email address

## Response `200`

Array of creation results, one per input item.

Per-item error codes:

| error | Meaning |
|-------|---------|
| 3 | `InvalidInput` — validation failed for this item |

- object[]
  - `id` integer, nullable — ID of the created item, null if creation failed
  - `error` integer, nullable — Error code if creation failed
  - `errorDetails` string, nullable — Human-readable error description if creation failed

## Other responses

- `400` — Request body validation failure, or a business-rule rejection.
- `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme.
- `403` — User lacks permission to create accounts
- `429` — Too Many Requests

---

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