---
title: "Create a sales channel"
method: POST
path: "/api/ecommerce/v1/stores/{store_id}/sales-channels"
tags: ["Ecommerce: Sales channels"]
---

# Create a sales channel

`POST /api/ecommerce/v1/stores/{store_id}/sales-channels`

Create a sales channel for a store. A "custom" channel is headless: build your own frontend and keep
your catalog, orders, shipping and payments in sync through the Ecommerce API. A "quick-link" channel
is a hosted one-page store whose handle is auto-generated.

## Path parameters

- `store_id` string, required

## Request body

- EcommerceV1SalesChannelStoreRequest
  - `type` 'custom' | 'quick-link', required — Sales channel type. "custom" is a headless channel: it requires a name and takes an optional public url. "quick-link" is a one-page store whose handle is auto-generated; it supports neither name nor url.
  - `name` string — Merchant-facing custom name. Required for custom channels; not supported for quick-link.
  - `url` string, nullable — Optional public url for the channel. Custom channels only; not supported for quick-link.

## Response `201`

Created response

- EcommerceV1SalesChannelSalesChannelCreationResource
  - `sales_channel` object
    - `id` string — Sales channel ID
    - `type` 'builder' | 'horizons' | 'tiktok' | 'custom' | 'quick-link' | 'wordpress' — Sales channel type
    - `is_primary` boolean — Whether this is the primary sales channel.
    - `is_active` boolean — Whether the sales channel is active.
    - `external_id` string, nullable — External identifier for the sales channel.
    - `name` string, nullable — Merchant-facing custom name.
    - `domain` string, nullable — Public address where the custom sales channel lives.

## Other responses

- `401` — Unauthenticated response
- `422` — Validation error response
- `500` — Error response

## Changes

- **2026-08-20** `b94885e042b8` — 3 info
  - api operation id `ecommerce_createCustomSalesChannelV1` removed and replaced with `ecommerce_createASalesChannelV1`
  - the request property `name` became optional
  - added the new `quick-link` enum value to the request property `type`
- **2026-07-03** `64006e65f220` — 1 info
  - api operation id `ecommerce_createACustomSalesChannelV1` removed and replaced with `ecommerce_createCustomSalesChannelV1`
- **2026-07-03** `4e80123a0ad5` — 1 info
  - endpoint added
- **2026-06-09** `d05574986eb1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hostinger/apis/hostinger-api/changes/api/ecommerce/v1/stores/:store_id/sales-channels/post.md)

---

[API](https://skmtc.dev/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.dev/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hostinger/hostinger-api/revisions/75f6fb63f779/schema)