API ReferenceCampaignsToll-Free

Upsert Toll-Free Campaign

Create a new toll-free campaign or updates an existing one.

Omit campaignId to create a campaign.

Headers

PINNACLE-API-KEYstringRequired

Request

This endpoint expects an object.
brandintegerOptional
Brand id.
campaignIdintegerOptional
Unique identifier for the campaign.
monthlyVolumeenumOptional
Message volume.
namestringOptional
Display name of the campaign.
optInobjectOptional

Opt-in keyword settings.

productionMessageContentstringOptional<=1000 characters
Explain message that would be sent.
useCaseobjectOptional
Use case classification for the campaign.

Response

Successfully created or updated toll-free campaign.

brandobject
Brand associated with this campaign.
statusenum

Current review status of the brand.

INCOMPLETE: Has not been submitted.
PENDING: Currently being reviewed.
VERIFIED: Verified and good to go.
UNVERIFIED: No longer verified due to an update in the brand details.
VETTED: Brand has been vetted by an external provider and has received vetting scores.

Allowed values:
campaignIdinteger or null
Unique identifier for the campaign.
monthlyVolumeenum or null
Message volume.
namestring or null
Display name of the campaign.
optInobject or null

Opt-in keyword settings.

productionMessageContentstring or null
Explain message that would be sent.
useCaseobject or null
Use case classification for the campaign.

Errors