API Overview
Get started with the Talkturo REST API — base URL, authentication, response format, rate limits, and available endpoint groups.
{
"success": true,
"data": {
"id": "ast_9f3d2c11",
"name": "Inbound Support Assistant"
}
}
{
"success": false,
"error": "Unauthorized"
}
Build on the Talkturo API
Build integrations and automations on top of Talkturo's voice AI platform with a REST API for assistants, telephony, phone numbers, credits, CRM data, workflows, and account management. Use this page to understand the API's core conventions and find the endpoint group you need.
Send all API requests to https://api.talkturo.com/api.
Authenticate requests
Talkturo supports three authentication methods. Most external integrations should use API keys, while browser and desktop clients use platform-specific authentication flows.
Use a bearer token that starts with tk_live_ or tk_test_ to authenticate server-to-server requests. API keys support scopes and have a default rate limit of 1000 requests per hour.
See Authentication for header format, scope behavior, and security guidance.
The Talkturo web app uses authenticated session cookies for browser-based requests. This method is intended for first-party web sessions, not external backend integrations.
See Authentication for when session-based authentication applies.
The desktop app uses bearer JWT tokens for authenticated API access. This flow is specific to desktop clients that authenticate through Talkturo user sessions.
See Authentication and Desktop Auth for details.
Understand the response format
Most endpoints return JSON in a consistent envelope so you can handle success and failure predictably across the API. Successful responses return a success flag and response data, while failed responses return a success flag and error details.
Handle HTTP status codes
Talkturo uses standard HTTP status codes in addition to the JSON response body. Check the status code first, then inspect the response envelope for details your application can log or surface.
| Status | Meaning |
|---|---|
200 | Request succeeded |
201 | Resource created |
400 | Bad request |
401 | Unauthorized |
402 | Insufficient credits |
403 | Forbidden |
404 | Not found |
500 | Server error |
Plan for rate limits
API keys are limited to 1000 requests per hour by default. If you build background jobs, retries, or bulk syncs, add backoff and retry handling so your integration degrades gracefully when it reaches the limit.
Browse endpoint groups
Start with the group that matches the resource or workflow you need to integrate. Each reference page documents endpoints, authentication requirements, and request or response details for that area of the API.
Authentication
Learn how to authenticate requests with API keys, session cookies, and JWT bearer tokens.
API Keys
Create, list, update, test, and revoke API keys for account-level access.
Assistants
Create, update, clone, and delete voice assistants and manage assistant configuration.
Telephony
Configure inbound and outbound calling, telephony settings, and test calls for assistants.
Phone Numbers
Search, purchase, retrieve, and release phone numbers used with Talkturo telephony.
Credits
Check balances, deduct usage credits, manage auto-reload, and start checkout flows.
Billing
Work with invoices and billing-related endpoints, including webhook-driven payment flows.
CRM Contacts
List, create, update, delete, and import contact records for CRM workflows.
CRM Companies
Manage company records and view contacts associated with each company.
CRM Opportunities
Create and manage opportunities used in pipeline and revenue workflows.
CRM Custom Fields
Define and manage custom CRM fields for contacts, companies, and related records.
CRM Campaigns
Manage outbound campaigns, campaign contacts, dashboards, and campaign run actions.
TurboFlow
Build and run workflow automations, triggers, integrations, secrets, and AI-assisted flow tools.
Webhooks
Receive event callbacks and work with inbound webhook endpoints across the platform.
Desktop Auth
Authenticate desktop clients with JWT bearer tokens and desktop-specific auth routes.
Knowledge Base
Upload, list, and remove assistant knowledge base files used to ground responses.
Start with the most common integration path
Most external developers begin with API keys, then move into assistants, telephony, or CRM endpoints depending on the product they are building. If you are setting up a new integration, read Authentication first, then continue to the resource-specific reference page for your use case.