---
title: "Create contacts"
method: POST
path: "/v3/contacts/batch"
tags: ["contacts", "v3"]
---

# Create contacts

`POST /v3/contacts/batch`

## Request body

- CreateBulkContactSchema[]
  - `full_name` string — Full Name of contact
  - `email` string — Email of contact. Can be optional only if anonymous contact feature is enabled.
  - `phone` string — Phone number of the contact
  - `mobile` string — Mobile number of the contact
  - `job_title` string — Job Title of the contact
  - `contact_type` 'contact' | 'employee' — Type of contact
  - `contact_list_ids` number[] — List ids to which the contact should be added
  - `referenceId` string — Reference ID of the anonymous contact
  - `unique_id` string — Unique ID of the contact
  - `unsubscribed` boolean — Unsubscribed status of the contact
  - `unsubscribe_text` string — Reason for unsubscribing

## Response `202`

Accepted

---

[API](https://skmtc.net/surveysparrow/apis/api-documentation.md) · [All operations](https://skmtc.net/surveysparrow/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surveysparrow/api-documentation/versions/f9da74f558da/schema)