Skip to content
Tallyraydocs

Make a source schedule: the hours of the week it runs in, and up to 100 source objects it pauses outside them and resumes inside them, each on one schedule at most. It runs dry, recording what each boundary would change, unless status says active or paused

POST
/v1/buyer/automation/schedules
curl --request POST \
  --url https://example.com/v1/buyer/automation/schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "leave_paused": true, "name": "example", "objects": [ { "connection_id": 1, "key": { "country": "example", "source_campaign": "example", "values": [ "example" ] }, "level": "campaign" } ], "status": "active", "week": { "hours": [ 1 ], "time_zone": "example" } }'

Who: a workspace’s buyer, or its key. API keys with the buyer:write scope.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
Idempotency-Key
string
<= 64 characters

Made once per action and sent again on every retry of it, so the service acts once: the request_id of the create or money-moving call; a new one when left out

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
leave_paused
boolean
name
string | null
objects
Array<object> | null
object
connection_id
required
integer format: int64
key
required
object
country
string
source_campaign
string
values
required
Array<string>
level
required
string
Allowed values: campaign ad_group ad placement
status
string | null
Allowed values: active dry_run paused archived
week
Any of:
object
hours
required
Array<integer>
time_zone
string

Responses

Section titled “Responses”

201

Section titled “201”

Created

Media typeapplication/json
object
created_at
required
string format: date-time
created_by
required
Any of:
object
account
string
id
string
kind
required
string | null
Allowed values: user api_key service system postback rule tuner schedule
name
string
id
required
integer format: int64
last_transition_at
required
string | null format: date-time
last_transition_id
required
string
name
required
string
next_boundary_at
required
string | null format: date-time
objects
required
Array<object>
object
connection
required
object
id
required
integer format: int64
name
string
key
required
object
country
required
string
source_campaign
required
string
values
required
Array<string>
level
required
string | null
Allowed values: campaign ad_group ad placement
sequence
required
integer format: int64
status
required
string | null
Allowed values: active dry_run paused archived
updated_at
required
string format: date-time
updated_by
required
Any of:
object
account
string
id
string
kind
required
string | null
Allowed values: user api_key service system postback rule tuner schedule
name
string
week
required
object
hours
required
Array<integer>
time_zone
required
string
workspace_id
required
integer format: int64

Example 

{
  "created_by": {
    "kind": "user"
  },
  "objects": [
    {
      "level": "campaign"
    }
  ],
  "status": "active",
  "updated_by": {
    "kind": "user"
  }
}

default

Section titled “default”

An error, as go-commons apperr maps it

Media typeapplication/json
object
error
required
object
code
required
string
fields
object
key
additional properties
string
message
required
string

Example generated

{
  "error": {
    "code": "example",
    "fields": {
      "additionalProperty": "example"
    },
    "message": "example"
  }
}