# Create a store

> POST /stores endpoint of the Proteside API: parameters, request body, responses and code samples.

URL: https://docs.proteside.com/en/docs/api/reference/stores/createStore

## Method and route

`POST /stores`

Same steps as the onboarding wizard: normalized + globally unique domain (`409 conflict`), plan store limit (`403 plan_limit`), store + SDK config + recipients (keys are not stored in clear text) + default e-mail channel for the owner + payment pages. The response includes the `sdk_key` and ready-to-paste install snippets.

## Parameters

- `org_id` (query, `string`): Partners only (`orgs:manage`): act on this child organization. May also be sent as `org_id` in JSON bodies.
- `Idempotency-Key` (header, `string`): Replays the original response for 24 h

## Responses

- `201`: Created
- `400`: Validation error
- `403`: Plan does not allow the action
- `409`: Conflict

Full OpenAPI specification: https://app.proteside.com/api/v1/openapi.json
