---
title: "Add Stores in Bulk"
method: POST
path: "/v2/locations/stores"
---

# Add Stores in Bulk

`POST /v2/locations/stores`

Create up to 100 stores in a single request.

## Query parameters

- `inheritLocale` boolean

## Headers

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

## Request body

- object[]
  - `code` string, required — Unique store code. Lowercase letters, digits, periods, underscores, hyphens. Max 50 characters.
  - `name` string, required — Display name. Letters, digits, underscores, and spaces. Cannot equal ROOT.
  - `areaParentCode` string, required — Code of the parent zone. Must be an existing active zone.
  - `groupParentCode` string, required — Code of the parent concept. Must be an existing active concept.
  - `language` string — IETF BCP 47 language code (e.g. en-IN). Required when inheritLocale is false.
  - `currency` string — ISO 4217 currency code (e.g. INR). Required when inheritLocale is false.
  - `timezone` string — IANA timezone name (e.g. Asia/Kolkata). Required when inheritLocale is false.
  - `description` string — Free-text description of the store.
  - `isActive` boolean — Whether the store is active. Defaults to true when omitted.
  - `isAdmin` boolean — Whether the store has admin access. Defaults to false.
  - `latitude` string — Latitude coordinate of the store.
  - `longitude` string — Longitude coordinate of the store.
  - `email` string — Contact email address for the store.
  - `mobile` string — Contact mobile number for the store.
  - `landline` string — Contact landline number for the store.
  - `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 stores 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 stores created, some failed.
- `400` — All items failed, batch size limit exceeded, 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)