Create a sales channel

Create a sales channel for a store.

Create a sales channel

post

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.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

store_idstringRequired

The ID of the store to create the sales channel for.

Example: store_01J8Z5F8W9K8M4A7B3C2D1E0FG

Body

typestring · enumRequired

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.

Example: customPossible values:

namestring · max: 100Optional

Merchant-facing custom name. Required for custom channels; not supported for quick-link.

Example: Vintagio Onepager

urlstring · max: 2048 · nullableOptional

Optional public url for the channel. Custom channels only; not supported for quick-link.

Example: https://www.bestshirt.vintagio.com

Responses

201

Created response

application/json

401

Unauthenticated response

application/json

422

Validation error response

application/json

500

Error response

application/json

post/api/ecommerce/v1/stores/{store_id}/sales-channels

POST /api/ecommerce/v1/stores/{store_id}/sales-channels HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "type": "custom",
  "name": "Vintagio Onepager",
  "url": "https://www.bestshirt.vintagio.com"
}

{
  "sales_channel": {
    "id": "scha_01J8Z5F8W9K8M4A7B3C2D1E0FG",
    "type": "custom",
    "is_primary": false,
    "is_active": true,
    "external_id": null,
    "name": "Vintagio Onepager",
    "domain": "https://www.bestshirt.vintagio.com"
  }
}