Start Voice Campaign API-v2¶

Use this API to start an active Voice campaign for a given stream ID and campaign ID.

Method	POST
Endpoint	`https://{{host}}/api/v2/public/{{streamID}}/campaign/trigger/{{campaignId}}?accountId={{accountId}}\&campaignType=voice\&trigger=play`
Content-Type	`application/json`
Authorization	`auth: {{JWT}}` See How to generate the JWT Token
API Scope	Campaign Management

Path Parameters¶

Parameter	Description	Type
`host`	Environment URL, for example, `https://platform.kore.ai`	string, required
`streamId`	Bot ID or Stream ID. You can get it from the general settings page.	string, required
`campaignId`	Unique identifier of the campaign to trigger.	string, required

Query Parameters¶

Parameter	Description	Type
`campaignType`	Type of campaign. Use `"voice"` for voice campaign.	string, required
`trigger`	Action to perform. Use `"play"` to start.	string, required

Sample Request¶

curl --location 'https://{{host}}/api/v2/public/{{streamID}}/campaign/trigger/{{campaignId}}?accountId={{accountId}}&campaignType=voice&trigger=play' \
--header 'auth: <token>' \
--header 'accountid: 67777ce93e25326494xxxxx' \
--header 'iid: st-0603182c-7ffb-53c3-b307-47ca14bxxxxx' \
--header 'Content-Type: application/json' \
--data '{}
'

Headers¶

Header	Description	Required/Optional
`auth`	JWT token for authentication.	required
`iid`	The Application Id.	required
`accountId`	The Account Id.	required

Sample Response¶

{
    "status": "Active",
    "message": "Campaign Started",
    "totalCallsCompleted": 0,
    "updatedAt": "2025-12-05T11:56:13.241Z",
    "campaignInstanceId": "cid-835ee4a-697e-4846-8340-7e3e301xxxxx"
}

Response Parameters¶

Parameter	Description	Type
`status`	Indicates the current status of the campaign. For example, `Active`	string
`message`	Success confirmation message. For example, `Campaign Started`	string
`totalCallsCompleted`	Number of completed calls at the time of starting the campaign.	number
`updatedAt`	ISO timestamp when the campaign was activated.	string
`campaignInstanceId`	ID of the specific campaign instance that was started.	string

Send Feedback