---
title: "Bulk upsert customers"
method: POST
path: "/api/v1/customers/bulk"
tags: ["Customers"]
---

# Bulk upsert customers

`POST /api/v1/customers/bulk`

## Request

- Base URL: `https://api.simplesat.io`
- URL: `https://api.simplesat.io/api/v1/customers/bulk`
- Auth: API key in header `X-Simplesat-Token`

Bulk upsert customers, creating or updating multiple customers at once.

Maximum 1000 customers per request.

Updating the `custom_attributes` or `tags` fields will overwrite any existing values.

Customers accept arrays in `custom_attributes`.

Customers with invalid data will be ignored.

Required scopes: `write customers`

## Request body

- object
  - `customers` object[]
    - `external_id` string
    - `email` string
    - `name` string
    - `tags` string[]
    - `custom_attributes` object
    - `company` string

## Response `200`

Successful response

- object
  - `request_id` string
  - `detail` string

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/simplesat/apis/simplesat-api-v1.md) · [All operations](https://skmtc.dev/simplesat/apis/simplesat-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/simplesat/apis/simplesat-api-v1/revisions/1c245425416b?raw)