Campaigns

Update Campaign

Path parameters

idstringRequired

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringOptional
This is the name of the campaign. This is just for your own reference.
assistantIdstringOptional
This is the assistant ID that will be used for the campaign calls. Can only be updated if campaign is not in progress or has ended.
workflowIdstringOptional
This is the workflow ID that will be used for the campaign calls. Can only be updated if campaign is not in progress or has ended.
phoneNumberIdstringOptional
This is the phone number ID that will be used for the campaign calls. Can only be updated if campaign is not in progress or has ended.
schedulePlanobjectOptional
This is the schedule plan for the campaign. Can only be updated if campaign is not in progress or has ended.
statusenumOptional
This is the status of the campaign. Can only be updated to 'ended' if you want to end the campaign. When set to 'ended', it will delete all scheduled calls. Calls in progress will be allowed to complete.
Allowed values:

Response

statusenum
This is the status of the campaign.
Allowed values:
namestring
This is the name of the campaign. This is just for your own reference.
phoneNumberIdstring
This is the phone number ID that will be used for the campaign calls.
schedulePlanobject
This is the schedule plan for the campaign.
customerslist of objects
These are the customers that will be called in the campaign.
idstring
This is the unique identifier for the campaign.
orgIdstring
This is the unique identifier for the org that this campaign belongs to.
createdAtstringformat: "date-time"

This is the ISO 8601 date-time string of when the campaign was created.

updatedAtstringformat: "date-time"

This is the ISO 8601 date-time string of when the campaign was last updated.

callsobject
This is a map of call IDs to campaign call details.
callsCounterEndeddouble
This is the number of calls that have ended.
endedReasonenum or null
This is the explanation for how the campaign ended.
Allowed values:
assistantIdstring or null

This is the assistant ID that will be used for the campaign calls. Note: Either assistantId or workflowId can be used, but not both.

workflowIdstring or null

This is the workflow ID that will be used for the campaign calls. Note: Either assistantId or workflowId can be used, but not both.