Skip to main content

​
Get Your API Key

First, grab your API key from the dashboard—you’ll need it to authenticate every request.
1

Sign in to your dashboard

Open app.getarbol.com and log in. Don’t have an account? Create one free.
2

Generate an API key

Go to Settings → API Keys and click Create API Key. Give it a name and copy the key—you won’t see it again.
3

Keep it secure

Store your key somewhere safe. Never commit it to Git or expose it in client-side code.

​
Make Your First API Call

All requests require your API key in the Authorization header as a Bearer token. Let’s list your agents to verify everything works.

​
List Your Agents

curl -X GET https://api.getarbol.com/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Create Your First Agent

Now let’s create an AI agent that can handle phone calls. This agent will answer questions about your products. 
curl -X POST https://api.getarbol.com/agents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Agent",
    "instructions": "You are a helpful assistant that answers questions about our products.",
    "language": "en"
  }'

​
Make an Outbound Call

Ready to make your agent call someone? Create a conversation to start an outbound call. 
curl -X POST https://api.getarbol.com/conversations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agt_your-agent-id",
    "contactId": "cnt_your-contact-id",
    "direction": "outbound"
  }'

​
Next Steps

API Reference

Browse all endpoints and see example requests

Configure Agents

Customize voices, languages, and behaviors

Manage Contacts

Store contacts with custom fields

Run Campaigns

Call thousands of contacts automatically