Vouchers

Add an offering to a voucher's valid-offerings allowlist

Appends a single offering to the voucher's valid_offerings list. No-op if the offering is already present (idempotent on offering_id).

Use the bulk updateVoucher endpoint when replacing the entire allowlist in one call.

Requires the update ability on the Voucher — typically granted by holding SETTINGS_MANAGE on the voucher's site.

post/shop/vouchers/{voucherId}/offerings

Request body

offering_type'appointment' | 'area_booking' | 'course' | 'hotel_room_reservation' | 'package' | 'product' | 'session' | 'table_reservation' required

Snake-case type of the offering being added (e.g. appointment, session, package).

offering_idstring required

Identifier of the offering to add to this voucher's valid-offerings list. Paired with offering_type to disambiguate which collection the ID belongs to.

Example request

{
  "offering_type": "session",
  "offering_id": "65f0a1b2c3d4e5f6a7b8c9d4"
}

Response

A single Voucher.

Example response

{
  "data": {
    "id": "65f0a1b2c3d4e5f6a7b8c9d0",
    "name": "Twilight Spa Day Gift Voucher",
    "description": "A 90-minute treatment, lunch, and full access to the spa facilities.",
    "processor_voucher_id": "gp_8421",
    "price": 12500,
    "currency": "gbp",
    "processor": "giftpro",
    "processor_data": {},
    "valid_offerings": [
      {
        "offering_id": "65f0a1b2c3d4e5f6a7b8c9d1",
        "offering_type": "AppointmentType",
        "offering_name": "60-minute Aromatherapy Massage",
        "offering_details": {
          "membership_type_id": "9c8b7a6d-5e4f-3210-9876-543210fedcba",
          "membership_type_name": "Wellness Club Gold",
          "membership_rate_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
          "membership_rate_name": "Annual rolling",
          "duration": "P1Y",
          "duration_friendly": "1 year"
        }
      }
    ],
    "valid_weekdays": [
      "monday",
      "tuesday",
      "wednesday",
      "thursday",
      "friday"
    ],
    "invalid_date_set_ids": [
      "65f0a1b2c3d4e5f6a7b8c9aa"
    ],
    "site_id": "1f3c0e2a-9b8d-4c5e-a6f7-1234567890ab",
    "organisation_id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
    "processor_created_at": "2025-12-15T09:30:00+00:00",
    "created_at": "2026-01-04T11:00:00+00:00",
    "updated_at": "2026-04-22T14:18:00+00:00"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.