BillyDocumentation

Set the offers of a sales channel

Replaces the offers the channel sells with the list sent: an offer left out is taken off sale, and the call is applied entirely or not at all. Each offer is sold at every pricing of its own except the excluded ones, including pricings created later. A bundle is accepted only with the offers it contains. Sending the same list again changes nothing. At most 100 offers. Returns 404 when the channel does not exist or sells an event of another 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 PUT request to the live API with your own key, and will create or modify actual data.
PUT
/v1/sales-channels/{sales_channel_id}/offers

Replaces the offers the channel sells with the list sent: an offer left out is taken off sale, and the call is applied entirely or not at all. Each offer is sold at every pricing of its own except the excluded ones, including pricings created later. A bundle is accepted only with the offers it contains. Sending the same list again changes nothing. At most 100 offers. Returns 404 when the channel does not exist or sells an event of another organization.

Authorization

HTTPBearer
AuthorizationBearer <token>

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

Example: Bearer billy:o:yyyyyyyyyyyyyyyy:xxxxxxxxxxxxxxxxx

In: header

Path Parameters

sales_channel_id*Sales Channel Id

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 PUT /v1/sales-channels/{sales_channel_id}/offers. The list replaces the channel's current offers: an offer left out is taken off sale.

Response Body

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/sales-channels/string/offers" \  -H "Billy-API-Version: preview" \  -H "Content-Type: application/json" \  -d '{    "offers": [      {        "offerId": "off_01ABCDEFGHIJKLMN"      }    ]  }'
{  "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"}