---
title: "SELLER_ACCOUNT_STORE_CREATE - Create stores and link them to a user"
method: POST
path: "/v1/users/stores"
tags: ["Store"]
---

# SELLER_ACCOUNT_STORE_CREATE - Create stores and link them to a user

`POST /v1/users/stores`

## Request

- Base URL: `https://account.mirakl.net/api/channel-platform`
- URL: `https://account.mirakl.net/api/channel-platform/v1/users/stores`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mirakl/apis/mirakl-account-channel-platform-apis/docs/v1/users/stores/post.ts> (a function with typed inputs; its response is checked against the schema)

<div class="extension-title">Description</div>

Create multiple stores and link them to a user. This API should be used by connectors.

<div class="api-description-extension">
</div>

## Query parameters

- `token` string, required
- `link_stores_to_organization` boolean

## Request body

- SELLERACCOUNTSTORECREATERequest
  - `stores` SELLERACCOUNTSTORECREATERequestStores[], required: Stores to create
    - `access_expiration_date` string, date-time: Access expiration date
    - `channel_id` string, required: Channel id
    - `channel_store_id` string, required: Channel store id
    - `name` string, required: Store name
    - `state` string, required: Store state
    - `suspension_type` string: Store suspension type

## Response `201`

Stores have been created and linked to user. Depending on the value of link_stores_to_organization, the stores have also been linked to an organization

## Other responses

- `401`: Invalid app-auth token
- `403`: Unknown connector
- `409`: The user doesn't belong to the organization anymore, so the requested stores can't be created or linked to the organization. Can only be returned when link_stores_to_organization is true
- `410`: Invalid link-store token

## Changes

- **2026-10-10** `5adf79cafae2`: 2 info
  - added the new optional `query` request parameter `link_stores_to_organization`
  - added the non-success response with the status `409`

[Operation history](https://skmtc.dev/mirakl/apis/mirakl-account-channel-platform-apis/changes/v1/users/stores/post.md)

---

[API](https://skmtc.dev/mirakl/apis/mirakl-account-channel-platform-apis.md) - [All operations](https://skmtc.dev/mirakl/apis/mirakl-account-channel-platform-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/mirakl/apis/mirakl-account-channel-platform-apis/revisions/5adf79cafae2?raw)