create_campaign

Create a simple single-audio batch campaign.

Permission	telephony
REST equivalent	CreateCampaign

Creates a batch voice campaign with one audio/TTS message. Provide destinations via cdlc_id (from create_destination_base) or inline datajson.

Required parameters

Parameter	Type	Description
date_start	string	Start date YYYY-MM-DD
date_end	string	End date YYYY-MM-DD
time_start	string	Start time HH:MM
time_end	string	End time HH:MM

Audio (one required)

Parameter	Type	Description
content	string	Pre-recorded audio ID from get_tts_voices
text	string	TTS text (supports NOME, COD_CLI, EXTRA1–EXTRA3)

Destinations (one required)

Parameter	Type	Description
cdlc_id	string	Existing destination base ID
datajson	string	Inline JSON (same format as create_destination_base)

Common optional parameters

Parameter	Description
name	Campaign name (max 50 chars)
detail	Description (max 256 chars)
vel	Calls per minute: 1–100 or max
resends	Retries for unanswered: 1–3
sms_text	SMS sent after call (max 160 chars)

See REST CreateCampaign for the full parameter list.

Example

curl -X POST 'https://vox20.velip.com.br/mcpserver/velip' \
  -H 'Authorization: Bearer YOUR_TOKEN_30_CHARS' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "create_campaign",
      "arguments": {
        "date_start": "2026-06-01",
        "date_end": "2026-06-30",
        "time_start": "09:00",
        "time_end": "18:00",
        "text": "Olá NOME, mensagem de teste.",
        "cdlc_id": "789",
        "name": "June campaign"
      }
    }
  }'

Responses

Success:

{
  "success": true,
  "cp_id": "200",
  "message": "Campaign created"
}

Use change_campaign to activate (cp_active=1).