---
title: "Add Tills in Bulk"
method: POST
path: "/v2/locations/tills"
---

# Add Tills in Bulk

`POST /v2/locations/tills`

Create up to 50 tills in a single request.

## Headers

- `Authorization` string
- `X-CAP-API-OAUTH-TOKEN` string

## Request body

- object[]
  - `code` string, required — Unique till code. Lowercase letters, digits, periods, underscores, hyphens. Max 50 characters.
  - `name` string, required — Display name. Letters, digits, underscores, and spaces. Cannot equal root.
  - `storeParentCode` string, required — Code of the parent store. Must be an existing active store with locale configured.
  - `description` string — Free-text description.
  - `isActive` boolean — Whether the till is active. Defaults to true.
  - `isAdmin` boolean — Whether this till has admin privileges. Defaults to false.
  - `isDefault` boolean — Whether this is the default till for the parent store. Defaults to false.
  - `externalIds` object — Key-value pairs of external identifiers. Max five entries. Keys and values must be non-blank and max 200 characters each.
  - `customFields` object — Custom field key-value pairs. Keys must match custom fields configured for the org.

## Response `201`

All tills created successfully.

- BulkResponseList
  - `response` object[]
    - `entityId` integer — System ID of the updated concept. Present when the concept was identified, regardless of whether the update succeeded. Absent when the concept could not be identified, or when an unexpected error occurs.
    - `result` object — Echo of the submitted request object for this concept.
    - `errors` object[]
      - `status` boolean
      - `code` integer
      - `message` string
    - `warnings` object[]
      - `status` boolean
      - `code` integer
      - `message` string
  - `totalCount` integer — Total number of concept records in the request.
  - `failureCount` integer — Number of concepts that failed to update.

## Other responses

- `207` — Partial success — some tills created, some failed.
- `400` — All items failed, batch contains more than 50 items, or empty request body.

---

[API](https://skmtc.net/capillarytech/apis/sample-api.md) · [All operations](https://skmtc.net/capillarytech/apis/sample-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/capillarytech/sample-api/revisions/de241f2ed9b3/schema)