Skip to main content
POST
/
v1
/
voice
/
campaigns
/
{campaign_id}
/
end
End Campaign
curl --request POST \
  --url https://api.example.com/v1/voice/campaigns/{campaign_id}/end \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "campaign_id": "<string>",
  "message": "<string>",
  "powered_by": "<string>"
}

​
Description

Permanently ends a voice campaign. Unlike pause, ended campaigns cannot be resumed. Use this when you want to stop a campaign before all contacts are called.

​
Authentication

​
X-API-Key
string
required
Your Teli API key

​
Path Parameters

​
campaign_id
string
required
The campaign identifier

​
Response Fields

​
success
boolean
Whether the campaign was ended successfully
​
campaign_id
string
Campaign identifier
​
message
string
Success message
​
powered_by
string
Always returns “Teli”

​
Example Request

cURL
curl -X POST "https://api.teli.ai/v1/voice/campaigns/voice_campaign_abc123/end" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "campaign_id": "voice_campaign_abc123",
  "message": "Campaign ended",
  "powered_by": "Teli"
}
404
{
  "error": "Campaign not found",
  "success": false,
  "powered_by": "Teli"
}

​
Notes

  • Ending a campaign is permanent - it cannot be resumed
  • Calls currently in progress will complete
  • Call history and analytics remain accessible
  • Use Failed Numbers to get uncalled contacts for a new campaign