Ecommerce: Sales channels

Create a sales channel

Changed on

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.

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

Request

  • Base URL: https://developers.hostinger.com
  • URL: https://developers.hostinger.com/api/ecommerce/v1/stores/{store_id}/sales-channels
  • Auth: HTTP bearer

Path parameters

store_idstring required
Example:store_01J8Z5F8W9K8M4A7B3C2D1E0FG

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

Request body

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.

namestring

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

urlstring nullable

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

Example request

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

Response

Created response

Example response

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

Changes

  • b94885e042b8Revision changes
    • info

      api operation id ecommerce_createCustomSalesChannelV1 removed and replaced with ecommerce_createASalesChannelV1

    • info

      the request property became optional

    • info

      added the new quick-link enum value to the request property

  • 64006e65f220Revision changes
    • info

      api operation id ecommerce_createACustomSalesChannelV1 removed and replaced with ecommerce_createCustomSalesChannelV1