Promotions
Create a new promotion
Creates a new promotion for the workspace
Authorization
x-calry-api-key x-calry-api-key<token>
In: header
Header Parameters
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.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/api/v1/promotions" \ -H "Content-Type: application/json" \ -d '{ "name": "Summer Sale 2023", "thumbnailURL": "https://example.com/promotions/summer-sale-2023", "startDate": "2025-06-01T00:00:00.000Z", "endDate": "2025-08-31T23:59:59.999Z", "bookingPeriodStart": "2025-06-01T00:00:00.000Z", "bookingPeriodEnd": "2025-09-30T23:59:59.999Z", "discountPercentage": 15 }'{
"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"
}Empty
Empty