---
title: "Create contacts in bulk"
method: POST
path: "/contacts/bulk"
tags: ["Contacts"]
---

# Create contacts in bulk

`POST /contacts/bulk`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/contacts/bulk`
- Auth: HTTP bearer

Create multiple contacts in a single request.

## Request body

- BulkContactsDto
  - `contacts` CreateContact[], required
    - `type_contact` string, required
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `legal_name` string, nullable
    - `registration_number` string, nullable
    - `email` string, email, required
    - `mobile` string, required
    - `telephone` string, nullable
    - `website` string, uri, nullable
    - `color` string, nullable
    - `category` string, required
    - `address_line1` string, required
    - `address_line2` string, nullable
    - `address_city` string, required
    - `address_postal_code` string, required
    - `address_region` string, nullable
    - `address_country` string, required
    - `bank_name` string, nullable
    - `bank_address` string, nullable
    - `bank_city` string, nullable
    - `bank_postal_code` string, nullable
    - `bank_country` string, nullable
    - `iban` string, nullable
    - `swift_bic` string, nullable
    - `bank_account_holder` string, nullable
    - `professional_activity` string, nullable
    - `professional_card_number` string, nullable
    - `professional_card_issuing_location` string, nullable
    - `professional_card_issuing_date` string, date, nullable
    - `professional_card_expiry_date` string, date, nullable
    - `professional_registration_number` string, nullable
    - `professional_guarantor_id` string, uuid, nullable
    - `professional_insurance_company` string, nullable
    - `professional_insurance_policy` string, nullable
    - `professional_status` string, nullable

## Response `201`

Contacts created

- Contact[]
  - `id` string, uuid
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `email` string, email, nullable
  - `phone` string, nullable
  - `address` object, nullable
    - `street` string, nullable
    - `city` string, nullable
    - `postal_code` string, nullable
    - `country` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)