---
title: "Batch Create Contacts"
method: POST
path: "/api/v3/crm/{integration_id}/contacts/batch/create"
tags: ["CRM Contacts"]
---

# Batch Create Contacts

`POST /api/v3/crm/{integration_id}/contacts/batch/create`

Create multiple contacts in a single request.

## Path parameters

- `integration_id` string, uuid, required — The CRM integration ID

## Request body

- AppRoutesV3CrmContactsBatchCreateRequest — Request for batch creating contacts.
  - `contacts` CreateContactRequest[], required — List of contacts to create
    - `email` string, nullable
    - `firstname` string, nullable
    - `lastname` string, nullable
    - `phone` string, nullable
    - `mobilephone` string, nullable
    - `jobtitle` string, nullable
    - `company` string, nullable
    - `website` string, nullable
    - `address` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `zip` string, nullable
    - `country` string, nullable
    - `lifecyclestage` string, nullable
    - `hs_lead_status` string, nullable
    - `hubspot_owner_id` string, nullable
  - `company_id` string, nullable — CRM company/account ID to associate all contacts with

## Response `200`

Successful Response

- ContactListResponse — API response for listing contacts.
  - `results` AppRoutesV3CrmContactsContactResponse[], required
    - `id` string, required
    - `properties` object, required
    - `created_at` string, nullable
    - `updated_at` string, nullable
  - `has_more` boolean
  - `next_cursor` string, nullable

## Other responses

- `422` — Validation Error

---

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