Create or update campaign timetables (dayparting).

Create or update dayparting configuration for a campaign.

Dayparting allows you to control when your campaign is active during the week. You can specify active hours for each day of the week (1=Monday, 7=Sunday).

HOUR SEMANTICS:

• start_hour: Campaign starts at this hour (inclusive, 0-23)
• end_hour: Campaign stops at this hour (exclusive, 1-24)
• Example: start_hour=9, end_hour=17 runs from 9:00 AM to 5:00 PM
• For all-day: start_hour=0, end_hour=24

This endpoint performs an upsert operation - it will create new timetables or update existing ones based on the day_of_week. Days not in the request remain unchanged.

PUT /public/v1/campaign-service/campaigns/{campaign-id}/timetables

Create or update campaign timetables (dayparting).

cURL

curl --request PUT \
  --url https://api.topsort.com/public/v1/campaign-service/campaigns/{campaign-id}/timetables \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "timetables": [
    {
      "isActive": true,
      "startHour": 0,
      "endHour": 24
    }
  ]
}
'

200

{
  "campaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "timetables": [
    {
      "isActive": true,
      "updatedAt": "2023-11-07T05:31:56Z",
      "startHour": 0,
      "endHour": 24
    }
  ]
}

Authorizations

Authorization · string · header · required

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Path Parameters

campaign-id · string<uuid> · required

The ID of the campaign.

Query Parameters

vendor_id · string · required

The ID of the vendor.

Minimum string length: 1

Body

application/json

timetables · CampaignTimeTable · object[] · required

The schedule for the campaign.

Required array length: 1 - 7 elements

Show child attributes

Response

200

application/json

Successful Response

The schedule for the campaign.

campaignId · string<uuid> · required

The ID of the campaign.

timetables · CampaignTimeTableResponse · object[] · required

The schedule for the campaign.

Show child attributes