POST
/
api
/
v1
/
promotions
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Summer Sale 2023",
  "description": "Get 15% off on all summer bookings",
  "city": "San Francisco",
  "discountPercentage": 15,
  "workspaceID": "123e4567-e89b-12d3-a456-426614174000",
  "startDate": "2025-06-01T00:00:00.000Z",
  "endDate": "2025-08-31T23:59:59.999Z",
  "bookingPeriodStart": "2025-06-01",
  "bookingPeriodEnd": "2025-09-30",
  "couponCode": "SUMMER2023",
  "thumbnailURL": "https://example.com/promotions/summer-sale-2023",
  "status": "ACTIVE",
  "createdAt": "2025-05-15T10:30:00.000Z",
  "updatedAt": "2025-05-16T14:45:00.000Z"
}

Authorizations

​
x-calry-api-key
string
header
required

Headers

​
x-calry-tenant-id
string

Optional tenant ID to specify which tenant to operate as. Controls access to promotions and their associated listings. If not provided, the default tenant will be used.

Body

application/json

Response

201
application/json

Promotion created successfully

The response is of type object.