Getting StartedAPI Overview

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"
  }
}

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.

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.

StatusMeaning
200Request succeeded
201Resource created
400Bad request
401Unauthorized
402Insufficient credits
403Forbidden
404Not found
500Server 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.