---
title: "Create bulk of contacts"
method: POST
path: "/data/contacts/bulk"
tags: ["Contact"]
---

# Create bulk of contacts

`POST /data/contacts/bulk`

## Request

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

Create bulk of contacts (max 1000).

## Request body

- object
  - `contacts` object[]
    - `lastname` string
    - `firstname` string
    - `creation_date` string: This date of creation of this contact, will be used for trigger campaigns. Ex: Welcome email. Warning the timezone set for this date is the user api timezone and not the system timezone.
    - `language` string: en, fr, it, es, ...
    - `email` string
    - `cellphone` string
    - `lists` object[]
      - `id` integer
      - `name` string
    - `double_optin` object: [Optional] **Require subscribers to confirm their subscription by sending a confirmation request.**<br /> <br /> **Legacy Version**<br /> - `message`: id of the message that must be sent. This message must contain a link to $confirmUrl$<br /> - `reminder`: id of the reminder message. This message must contain $confirmUrl$ as well.<br /> - `reminder_delay`: if you want a reminder to be sent, specify the number of days between the first message and the reminder.<br /> ``` { "message": "aw94xefgh", "reminder": "94was76ef", "reminder_delay": 34 } ``` <br /> <br /> **Splio Edition 2025**<br /> - `enabled`: Enable double optin<br /> ``` { "enabled": true }```
    - `custom_fields` object[]
      - `id` integer
      - `name` string
      - `value` string: The custom field value, can be an integer, a float, a string or a date at format YYYY-MM-DD HH:MM:SS, depending on the configuration of the custom field

## Response `207`

contacts creation is successful.

## Other responses

- `400`: The request validation failed.
- `401`: Authentication failed.
- `403`: Forbidden.

## Changes

- **2026-11-03** `563a91bd331b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/splio/apis/splio-customer-platform/changes/data/contacts/bulk/post.md)

---

[API](https://skmtc.dev/splio/apis/splio-customer-platform.md) - [All operations](https://skmtc.dev/splio/apis/splio-customer-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/splio/apis/splio-customer-platform/revisions/563a91bd331b?raw)