Skip to main content
GET
/
v1
/
organizations
/
{org_id}
/
campaigns
List SMS Campaigns
curl --request GET \
  --url https://api.example.com/v1/organizations/{org_id}/campaigns \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "count": 123,
  "campaigns": [
    {
      "campaign_id": "<string>",
      "campaign_id_pk": "<string>",
      "campaign_name": "<string>",
      "campaign_type": "<string>",
      "status": "<string>",
      "campaign_create_time": {},
      "sms_agent_id": "<string>",
      "teli_sms_number": "<string>",
      "starting_message": "<string>",
      "objective_prompt": "<string>",
      "organization_id": "<string>",
      "user_id": "<string>",
      "created_by_user_id": "<string>",
      "tenant_id": "<string>",
      "enable_sms_to_voice": true,
      "voice_agent_id": "<string>",
      "outbound_number": "<string>",
      "drip_enabled": true,
      "drip_schedule": [
        {}
      ],
      "drip_start_datetime": {},
      "mms_media_url": "<string>",
      "followup_interval": 123,
      "use_jit_queue": true,
      "dry_run": true,
      "enable_number_validation": true,
      "extraction_fields": [
        {}
      ],
      "custom_follow_up": "<string>"
    }
  ],
  "powered_by": "<string>"
}

​
Description

Returns all SMS campaigns for an organization. Includes campaign configuration, status, and agent details.

​
Authentication

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

​
Path Parameters

​
org_id
string
required
Organization unique_id

​
Query Parameters

​
user_id
string
required
User unique_id
​
is_admin
boolean
default:"false"
If true, returns all org campaigns. If false, returns only user’s campaigns.

​
Response Fields

​
success
boolean
Whether the request was successful
​
count
integer
Total number of campaigns
​
campaigns
array
Array of campaign objects
​
powered_by
string
Always returns “Teli”

​
Example Request

cURL
curl -X GET "https://api.teli.ai/v1/organizations/1762896364768x389173798861431550/campaigns?user_id=1762896366429x599348279945132448&is_admin=true" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "count": 14,
  "campaigns": [
    {
      "campaign_id": "1762965054360x778625532252496000",
      "campaign_id_pk": "1762965054360x778625532252496000",
      "campaign_name": "test 4",
      "campaign_type": "OUTBOUND",
      "status": "ACTIVE",
      "campaign_create_time": "2025-11-12T16:31:02+00:00",
      "sms_agent_id": "1762904472817x422002938962921563",
      "teli_sms_number": "13135727768",
      "starting_message": "Hi {{first_name}}, did you want to develop a software for your business? I want to be able to help you with software consulting. Whether it's ed tech or bio tech or advanced automonomous technology, I am here to help you out. Please let me know if there's anything you want from me for your best software solution!",
      "objective_prompt": "You are working for John Nir Software Solutions. You are supposed to ask users if they want any consulting or software development support. If yes, ask them their budget for the software. \n\nIf you are able to get a budget. Please make an estimate and tell them what their budget is worth! 1000 for software UI, 1000 for simple backend infrastructure. 2000 on top of 1000 for tier 1 complexity. If they agree to consult, ask when is it best time to reach out by our team. ",
      "organization_id": "1762896364768x389173798861431550",
      "user_id": "1762896366429x599348279945132448",
      "created_by_user_id": "1762896366429x599348279945132448",
      "tenant_id": "your_tenant",
      "enable_sms_to_voice": false,
      "voice_agent_id": null,
      "voice_agent_id": null,
      "outbound_number": null,
      "drip_enabled": false,
      "drip_schedule": [],
      "drip_start_datetime": null,
      "custom_follow_up": "",
      "mms_media_url": null,
      "followup_interval": 0,
      "use_jit_queue": true,
      "dry_run": false,
      "enable_number_validation": false,
      "extraction_fields": []
    },
    {
      "campaign_id": "1763500495035x142476011111897800",
      "campaign_id_pk": "1763500495035x142476011111897800",
      "campaign_name": "ronaldo reach",
      "campaign_type": "OUTBOUND",
      "status": "ACTIVE",
      "campaign_create_time": "2025-11-18T21:15:01+00:00",
      "sms_agent_id": "1763490401240x434214358565169285",
      "teli_sms_number": "13135727768",
      "starting_message": "Hi {{first_name}}, did you want to develop a software for your business?\n",
      "objective_prompt": "You are working for John Nir Software Solutions. You are supposed to ask users if they want any consulting or software development support. If yes, ask them their budget for the software. If they give you a budget, tell them an approximate cost of the software in industry standards. \n\nIf the user wants to talk over phone, make sure to trigger a call and ask the deatils. if user wants to schedule a call, schedule the call and call them at the given time. ",
      "organization_id": "1762896364768x389173798861431550",
      "user_id": "1762896366429x599348279945132448",
      "created_by_user_id": "1762896366429x599348279945132448",
      "tenant_id": "your_tenant",
      "enable_sms_to_voice": true,
      "voice_agent_id": "agent_86f826bf8f59bacd5c10ae948a",
      "voice_agent_id": "agent_86f826bf8f59bacd5c10ae948a",
      "outbound_number": "+15174686941",
      "drip_enabled": false,
      "drip_schedule": [],
      "drip_start_datetime": null,
      "custom_follow_up": "",
      "mms_media_url": null,
      "followup_interval": 0,
      "use_jit_queue": true,
      "dry_run": false,
      "enable_number_validation": false,
      "extraction_fields": []
    }
  ],
  "powered_by": "Teli"
}
400 (Missing User ID)
{
  "error": "user_id required",
  "success": false,
  "powered_by": "Teli"
}
500 (Server Error)
{
  "error": "Failed to list campaigns",
  "success": false,
  "powered_by": "Teli"
}

​
Campaign Statuses

StatusDescription
ACTIVECampaign is currently running and sending messages
PAUSEDCampaign is temporarily paused
COMPLETEDAll contacts have been messaged
ENDEDCampaign has been manually ended

​
SMS-to-Voice Transfer

Campaigns can escalate from SMS to voice calls when enable_sms_to_voice: true: SMS-Only Campaigns: 
{
  "enable_sms_to_voice": false,
  "voice_agent_id": null,
  "voice_agent_id": null,
  "outbound_number": null
}
SMS + Voice Transfer Campaigns: 
{
  "enable_sms_to_voice": true,
  "voice_agent_id": "agent_86f826bf8f59bacd5c10ae948a",
  "voice_agent_id": "agent_86f826bf8f59bacd5c10ae948a",
  "outbound_number": "+15174686941"
}
When enabled:
  • AI can trigger phone calls during SMS conversations
  • Uses specified voice agent and outbound number
  • Seamless transition from text to voice

​
Variable Substitution

All message templates support dynamic variables:
  • {{first_name}} - Contact’s first name
  • {{last_name}} - Contact’s last name
  • {{email}} - Contact’s email
  • Custom fields from lead data

​
Notes

  • SMS campaigns use agents for AI-powered conversations
  • Drip schedules enable automated follow-up sequences
  • SMS-to-voice transfer allows escalation to phone calls
  • Emoji support in messages (as shown in “emoji test” campaign)
  • Admin users see all org campaigns, regular users see only their own
  • Phone numbers may appear with or without + prefix in teli_sms_number