PUT
/
api
/
v1
/
outbound
/
campaigns
/
{campaign_id}
import os
import syllable_sdk
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.outbound.campaigns.update(campaign_id=627690, outbound_campaign_input={
        "campaign_name": "Outbound Campaign 1",
        "description": "This is a test campaign",
        "label": "demo",
        "campaign_variables": {
            "key": "value",
            "key2": "value2",
        },
        "daily_start_time": "09:00:00",
        "daily_end_time": "17:00:00",
        "source": "account@email.com",
        "caller_id": "19995551234",
        "retry_interval": "12h",
        "active_days": [
            syllable_sdk.DaysOfWeek.SUN,
        ],
    })

    # Handle response
    print(res)
{
  "campaign_name": "Outbound Campaign 1",
  "description": "This is a test campaign",
  "label": "test",
  "campaign_variables": {
    "key": "value",
    "key2": "value2"
  },
  "daily_start_time": "09:00:00",
  "daily_end_time": "17:00:00",
  "source": "+19032900844",
  "caller_id": 19995551234,
  "hourly_rate": 25,
  "retry_count": 1,
  "retry_interval": "30m",
  "active_days": "[\"mon\", \"tue\", \"wed\", \"thu\", \"fri\"]",
  "id": 1,
  "agent_id": "agent_id",
  "created_at": "2025-04-19T00:00:00Z",
  "updated_at": "2025-04-19T00:00:00Z",
  "last_updated_by": "user@email.com"
}

Authorizations

​
Syllable-API-Key
string
header
required

Path Parameters

​
campaign_id
integer
required

Body

application/json
​
campaign_name
string
required

Human readable name of campaign

Example:

"Outbound Campaign 1"

​
campaign_variables
object
required

Variables for campaign

Example:
{ "key": "value", "key2": "value2" }
​
caller_id
string | null
required

Caller ID for call

Example:

19995551234

​
active_days
enum<string>[]
required

Days of the week when campaign is active

Enum representing days of the week.

Available options:
mon,
tue,
wed,
thu,
fri,
sat,
sun
Example:

"[\"mon\", \"tue\", \"wed\", \"thu\", \"fri\"]"

​
description
string | null

Description of campaign

Example:

"This is a test campaign"

​
label
string | null

Label for campaign

Example:

"test"

​
daily_start_time
string | null

Start time of campaign each day

Example:

"09:00:00"

​
daily_end_time
string | null

End time of campaign each day

Example:

"17:00:00"

​
source
string | null

Source phone number, email, or SMS number

Example:

"+19032900844"

​
hourly_rate
integer
default:1

Target number of outreach calls per hour

Example:

25

​
retry_count
integer
default:0

Number of retries per target

Example:

1

​
retry_interval
string | null

How long to wait before retrying

Example:

"30m"

Response

200
application/json
Successful Response
​
campaign_name
string
required

Human readable name of campaign

Example:

"Outbound Campaign 1"

​
campaign_variables
object
required

Variables for campaign

Example:
{ "key": "value", "key2": "value2" }
​
caller_id
string | null
required

Caller ID for call

Example:

19995551234

​
active_days
enum<string>[]
required

Days of the week when campaign is active

Enum representing days of the week.

Available options:
mon,
tue,
wed,
thu,
fri,
sat,
sun
Example:

"[\"mon\", \"tue\", \"wed\", \"thu\", \"fri\"]"

​
id
integer
required

Unique ID for campaign

Example:

1

​
last_updated_by
string
required

Email of user who last updated campaign

Example:

"user@email.com"

​
description
string | null

Description of campaign

Example:

"This is a test campaign"

​
label
string | null

Label for campaign

Example:

"test"

​
daily_start_time
string | null

Start time of campaign each day

Example:

"09:00:00"

​
daily_end_time
string | null

End time of campaign each day

Example:

"17:00:00"

​
source
string | null

Source phone number, email, or SMS number

Example:

"+19032900844"

​
hourly_rate
integer
default:1

Target number of outreach calls per hour

Example:

25

​
retry_count
integer
default:0

Number of retries per target

Example:

1

​
retry_interval
string | null

How long to wait before retrying

Example:

"30m"

​
agent_id
integer | null

ID of agent assigned to campaign

Example:

"agent_id"

​
created_at
string

Timestamp of campaign creation

Example:

"2025-04-19T00:00:00Z"

​
updated_at
string

Timestamp of campaign update

Example:

"2025-04-19T00:00:00Z"