BillyDocumentation

Create a sales channel

Creates an online sales channel for one of your events, as a draft: buyers cannot reach it until it is published. It sells every session of the event, including those scheduled later, and no offer yet — set its offers next with PUT /v1/sales-channels/{salesChannelId}/offers. It gets your organization's default customer form. Returns 404 when the event does not exist or does not belong to your organization.

Preview release

This operation is only available on the preview release target — send Billy-API-Version: preview to reach it. Preview has no stability promise: its routes and payloads can change without notice, so pin a dated release before you depend on one. The playground below sends a real POST request to the live API with your own key, and will create or modify actual data.
POST
/v1/sales-channels

Creates an online sales channel for one of your events, as a draft: buyers cannot reach it until it is published. It sells every session of the event, including those scheduled later, and no offer yet — set its offers next with PUT /v1/sales-channels/{salesChannelId}/offers. It gets your organization's default customer form. Returns 404 when the event does not exist or does not belong to your organization.

Authorization

HTTPBearer
AuthorizationBearer <token>

API key authentication. Format: Bearer billy:o:<organization_id>:<api_key>

Example: Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx

In: header

Header Parameters

Billy-API-Version*string

Requested API version. Current context: preview.

Default"preview"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request body for POST /v1/sales-channels. The channel is created as a draft selling every session of the event, including those scheduled later, and no offer; its offers are set afterwards. Its opt-ins are set in the Studio.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/sales-channels" \  -H "Billy-API-Version: preview" \  -H "Content-Type: application/json" \  -d '{    "eventId": "evt_01ABCDEFGHIJKLMN",    "name": "Partner X"  }'
{  "id": "5ad8d09e-c789-49e6-a8f8-1434f880beeb",  "name": "Partner X",  "title": "Jazz Night — tickets",  "status": "DRAFT",  "openingDate": "2026-11-01T10:00:00+01:00",  "closingDate": "2026-12-01T23:00:00+01:00",  "customerFormId": "frm_01ABCDEFGHIJKLMN",  "optIns": [    {      "id": "newsletter",      "name": "Newsletter",      "mandatory": false,      "displayValues": {        "fr": "Recevoir la newsletter"      }    }  ],  "offers": [    {      "offerId": "331704d8-50bf-4e99-8d82-95c4974b1a2b",      "type": "TICKET",      "name": "Pass 2 jours",      "description": "<p>Accès aux deux journées</p>",      "eventId": "168c36ec-2e28-4312-be93-8893f0cc4d5e",      "currency": "EUR",      "images": [],      "tags": [        "pass"      ],      "minQuantityPerOrder": 1,      "maxQuantityPerOrder": 10,      "compareAtPrice": 55,      "createdAt": "2026-08-01T10:00:00+00:00",      "vatRate": 0.2,      "defaultMaximumCapacity": 500,      "attendeeFormId": "5d6e7f80-9a0b-4c1d-8e2f-3a4b5c6d7e8f",      "pricing": [        {          "pricingId": "9f2c1b44-77aa-4f10-9c3e-0d1b2e3f4a5b",          "name": "Tarif plein",          "price": 45,          "bundleOfferId": null,          "resaleEnabled": true        },        {          "pricingId": "b3e7d901-1c22-4a55-8f6d-7e8f9a0b1c2d",          "name": "Tarif étudiant",          "price": 32,          "bundleOfferId": null,          "resaleEnabled": false        },        {          "pricingId": "c4f8ea12-2d33-4b66-9a7e-8f9a0b1c2d3e",          "name": "Pass festival 3 dates",          "price": 36,          "bundleOfferId": "7a1b2c3d-4e5f-4061-8172-93a4b5c6d7e8",          "resaleEnabled": true        }      ],      "optionOffers": [        {          "offerId": "4c5d6e7f-8091-4a2b-b3c4-d5e6f7a8b9c0",          "pricingId": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9",          "minQuantityPerBase": 0,          "maxQuantityPerBase": 2        }      ],      "extras": [        {          "offerId": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",          "minQuantityPerTicket": 0,          "maxQuantityPerTicket": 3        }      ],      "minDistinctExtrasPerTicket": 0,      "maxDistinctExtrasPerTicket": null,      "inventory": [        {          "inventoryId": "e1f2a3b4-c5d6-4e7f-8091-a2b3c4d5e6f7",          "sessionId": "11223344-5566-4778-899a-bbccddeeff00",          "totalStock": 500,          "availableStock": 412        }      ]    }  ],  "createdAt": "2026-10-27T09:12:44.512000+00:00"}