Skip to main content
POST
/
v1
/
agents
curl -X POST https://api.teli.ai/v1/agents \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_type": "sms",
    "agent_name": "Sales Follow-up Agent",
    "starting_message": "Hi {{first_name}}, interested in our services?",
    "prompt": "You are a helpful sales agent. Ask about their budget and timeline. Be friendly and professional.",
    "organization_id": "1763070568417x631086913669115287",
    "user_id": "1763072368418x263803518630956376",
    "drip_schedule": [
      {"day": 1, "message": "Just checking in from yesterday!"},
      {"day": 3, "message": "Happy to help when you are ready!"}
    ]
  }'

{
  "success": true,
  "agent_id": "1763072369786x980265710064263640",
  "agent_type": "sms",
  "agent_name": "Sales Follow-up Agent",
  "has_drip_schedule": true,
  "organization_id": "1763070568417x631086913669115287",
  "created_by": "1763072368418x263803518630956376",
  "message": "SMS agent created successfully",
  "powered_by": "Teli"
}
Create an SMS agent for text-based AI conversations. SMS agents are simple to set up and support automated drip campaigns.
SMS agents have no additional charges beyond standard SMS costs per message.

​
Authorizations

​
X-API-Key
string
required
Authentication header containing your API key.

​
Required Fields

​
agent_type
string
required
Must be "sms" for SMS agents.
​
agent_name
string
required
Display name for the agent.Example: "Sales Follow-up Agent"
​
starting_message
string
required
First message sent to contacts. Supports variables: {{first_name}}, {{last_name}}Example: "Hi {{first_name}}, interested in our services?"
​
prompt
string
required
AI behavior instructions. Tells the agent how to respond.Example: "You are a sales agent for Acme Corp. Ask users about their needs, budget, and timeline. Be friendly and helpful."
​
organization_id
string
required
Organization unique_id.Example: "1763070568417x631086913669115287"
​
user_id
string
required
User unique_id (agent creator).Example: "1763072368418x263803518630956376"

​
Optional Fields

​
drip_schedule
array
Automated follow-up messages sent on specific days after initial contact.Each item: { "day": number, "message": string }Example:
[
  {"day": 1, "message": "Just checking in from yesterday!"},
  {"day": 3, "message": "Still here if you need anything!"},
  {"day": 7, "message": "Last follow-up - let me know if I can help!"}
]

curl -X POST https://api.teli.ai/v1/agents \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_type": "sms",
    "agent_name": "Sales Follow-up Agent",
    "starting_message": "Hi {{first_name}}, interested in our services?",
    "prompt": "You are a helpful sales agent. Ask about their budget and timeline. Be friendly and professional.",
    "organization_id": "1763070568417x631086913669115287",
    "user_id": "1763072368418x263803518630956376",
    "drip_schedule": [
      {"day": 1, "message": "Just checking in from yesterday!"},
      {"day": 3, "message": "Happy to help when you are ready!"}
    ]
  }'

{
  "success": true,
  "agent_id": "1763072369786x980265710064263640",
  "agent_type": "sms",
  "agent_name": "Sales Follow-up Agent",
  "has_drip_schedule": true,
  "organization_id": "1763070568417x631086913669115287",
  "created_by": "1763072368418x263803518630956376",
  "message": "SMS agent created successfully",
  "powered_by": "Teli"
}

​
Response Fields

​
agent_id
string
Agent identifier. Use this when creating SMS campaigns.
​
agent_type
string
Always "sms" for SMS agents.
​
has_drip_schedule
boolean
Whether automated follow-ups are configured.

​
Drip Schedule Best Practices

  • Day 1: Quick check-in, shows attentiveness
  • Day 3: Provide value or new information
  • Day 7: Final gentle follow-up
  • Keep messages under 160 characters for single-segment billing
  • Use {{first_name}} for personalization

​
Next Steps

  1. Create Contact List - Upload leads
  2. Create SMS Campaign - Launch your campaign