JustCall API Overview
JustCall API Overview
The JustCall REST API lets you integrate calling, texting, and contact management directly into your existing tools and workflows. Every action you can take in the JustCall dashboard — placing a call, sending an SMS, pulling call logs — is available programmatically.
Base URL
All API requests use the following base URL:
https://api.justcall.io/v2/
Authentication
Every request requires your API Key and API Secret, passed as HTTP headers:
curl -X GET "https://api.justcall.io/v2/calls" \
-H "Authorization: {api_key}:{api_secret}" \
-H "Content-Type: application/json"
You can generate your credentials in Settings → API & Webhooks inside the JustCall dashboard.
Response Format
All responses return JSON with this structure:
| Field | Type | Description |
|---|---|---|
status | string | success or error |
message | string | Human-readable status message |
data | object | The requested resource or result set |
count | integer | Total records (for list endpoints) |
Rate Limits
| Plan | Requests per minute |
|---|---|
| Team | 60 |
| Pro | 120 |
| Business | 300 |
Exceeding the limit returns a 429 Too Many Requests response. See API Rate Limits & Error Codes for retry strategies.
7 Things You Can Build with the JustCall API
1. Click-to-Call
Trigger an outbound call from your CRM or internal tool so agents never leave their workflow. See Click-to-Call via API.
2. SMS Sending
Send transactional or conversational text messages to customers on demand. See Send SMS via API.
3. Contact Sync
Keep your JustCall contact list in sync with your CRM or database by creating, updating, and searching contacts programmatically. See Contacts API.
4. Call Logging
Pull detailed call history — duration, recordings, agent notes, and dispositions — into your reporting tools. See Call Logs API.
5. Number Management
List available phone numbers, purchase new numbers, and assign them to teams or agents without touching the dashboard.
6. Recording Access
Download call recordings for compliance archival or quality assurance review. See Recordings API.
7. Analytics Export
Export call and SMS analytics data into your own BI tools for custom reporting and trend analysis.
Next Steps
- Authenticate your first request
- Set up webhooks for real-time events
- Understand error codes and rate limits