Thoughtly is an AI voice and chat agent platform that helps revenue and support teams contact every lead across every channel — voice, SMS, email, WhatsApp, and iMessage. The product combines a no-code agent designer (decision-tree builder, Vibes AI assistant, Genius knowledge base), a managed telephony layer (purchased numbers, branded calling, BYOC, voice cloning), and a public REST API for programmatically creating contacts, triggering outbound calls, and subscribing to call-completion webhooks.
URL: Visit APIs.json
Run: Capabilities Using Naftiko
- Voice AI, Chat AI, Conversational AI, AI Agents, Outbound Calling, Inbound Calling, Lead Conversion, SMS, WhatsApp, CRM, Telephony
- Created: 2026-05-24
- Modified: 2026-05-24
Public REST API for the Thoughtly platform. Manage Agents (called "interviews" in the API), create and update Contacts, trigger outbound calls, search call responses, subscribe to webhook events (NEW_RESPONSE, PHONE_TRANSFER, etc.), and trigger Webhook-driven Automations. Authentication uses two headers: x-api-token and team_id, both available from Developer Settings.
Base URL: https://api.thoughtly.com
Human URL: https://docs.thoughtly.com/developers
- Documentation — Developers
- Documentation — API Reference
- OpenAPI (upstream)
- OpenAPI (this repo)
- Spectral Rules
- JSON Schema — Contact
- JSON Schema — Agent
- JSON Schema — Call
- JSON Schema — Webhook
- JSON Structure — Contact
- JSON Structure — Call
- JSON-LD Context
- Example — Create Contact
- Example — Call A Contact
- Example — Subscribe Webhook
- Example — NEW_RESPONSE Webhook Payload
- Naftiko Capability — Agents
- Naftiko Capability — Contacts
- Naftiko Capability — Webhooks
| Method | Path | Operation |
|---|---|---|
| GET | /interview |
Get Agents |
| GET | /interview/{interview_id}/responses |
Search Calls |
| GET | /contact |
Get Contacts |
| POST | /contact/create |
Create Contact |
| GET | /contact/{id} |
Get Contact |
| DELETE | /contact/{id} |
Delete Contact |
| POST | /contact/call |
Call A Contact |
| GET | /user |
Get User Details |
| GET | /webhooks |
Get Currently Active Webhooks |
| POST | /webhooks/subscribe |
Subscribe To Webhook |
| DELETE | /webhooks/unsubscribe |
Unsubscribe From Webhook |
| POST | /webhook/automation/{automation_id} |
Trigger Automation With Webhook |
Every authenticated request requires two headers:
| Header | Purpose |
|---|---|
x-api-token |
API token from Developer Settings. |
team_id |
Team identifier scoping requests to a workspace. |
The single exception is POST /webhook/automation/{automation_id}, which is intentionally unauthenticated so external systems can trigger Webhook-driven Automations.
- 100 requests per minute per API key across all endpoints.
- A
429 Too Many Requestsresponse indicates throttling — apply exponential backoff. - Thoughtly does not auto-retry failed outgoing webhook deliveries; a 429 from a subscriber URL is retried once respecting
Retry-After.
See rate-limits/thoughtly-rate-limits.yml.
| Event | Description |
|---|---|
NEW_RESPONSE |
A call has completed; payload includes call metadata, agent info, structured transcript, and custom fields. |
PHONE_TRANSFER |
A call has been transferred (warm or cold) to another number. |
FOLDER_NEW_RESPONSE |
New response within a specific folder. |
FOLDER_PHONE_TRANSFER |
Phone transfer within a specific folder. |
ACTION_FAILED |
An in-call action failed. |
| Plan | Price | Included | Notes |
|---|---|---|---|
| Free | $0 | 10 minutes/month, unlimited seats | 14-day full-feature trial. |
| Starter | ~$30/month | 300 minutes | Overage approx $0.09/minute voice. |
| Enterprise | Custom | Custom | SSO, audit log, BYOC, BYOK, branded calling. |
| AppSumo Lifetime | One-time | Credit-based | 10 credits/min voice, 8 credits/SMS, 500 credits/phone-number/month, 1 credit/automation-step, 3 credits/chat-test, 200 credits per $1 carrier fees. |
See plans/thoughtly-plans-pricing.yml and finops/thoughtly-finops.yml.
CRM: Salesforce, HubSpot, Zoho CRM, GoHighLevel, Pipedrive, Attio, Keap, Fence Flow Scheduling: Calendly, Acuity Scheduling, Cal.com, Mindbody, Zoho Bookings Communication: Gmail, Slack, WhatsApp Business, iMessage/Lync Ticketing: Zendesk E-commerce: Shopify Productivity: Google Sheets, Airtable, Typeform, Trello, Smartsheet, Zoom Automation Platforms: Zapier, Make
Full integration index: docs.thoughtly.com/integrations/getting-started.
- Pricing: docs.thoughtly.com/platform/billing
- Changelog: docs.thoughtly.com/support/changelog
- Support: docs.thoughtly.com/support/getting-help
- FAQ: docs.thoughtly.com/resources/faq
- Glossary: docs.thoughtly.com/resources/glossary/overview
- Promptbooks: docs.thoughtly.com/promptbooks/browse
- Whitepapers: docs.thoughtly.com/resources/whitepapers/overview
- LinkedIn: linkedin.com/company/thoughtly-ai
- Kin Lane — apievangelist.com — kin@apievangelist.com