Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.topcalls.ai/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Connect Topcalls to your tools to automate the call lifecycle. Trigger calls when something happens in your CRM, push call outcomes into spreadsheets or messaging apps, and keep leads in sync between systems. Build flows visually, no code required.

What it does

Trigger calls from external events

Start a Topcalls call when a row is added to your CRM, a meeting is booked, or a form is submitted.

Deliver call outcomes

Route completed calls, transcripts, and dispositions into your CRM, sheets, or chat tools.

Sync leads bidirectionally

Keep lead data consistent between Topcalls and your source-of-truth systems.

Available triggers

Triggers start a flow when something happens in Topcalls. The names below match what you see in the in-product catalog.
TriggerFires when
When a Call EndsA call ends, regardless of outcome
When a Call FailsA call ends without reaching a person (no-answer, busy, failed, rejected, dispatch timeout)
When a Call Hits VoicemailA call is answered by a voicemail system instead of a person
When a Callback Is RequestedA call ends with a disposition meaning the caller asked for a callback
When an Appointment Is BookedA call ends with a disposition meaning an appointment was booked
When a Follow-up Is ScheduledA call ends with a disposition meaning a follow-up was scheduled
When a Conversion HappensA call ends with a disposition you have marked as a conversion

Available actions

Actions are steps you add to a flow to make Topcalls do something. Below is a representative set; the full catalog is visible in-product.
ActionEffect
Make a CallPlace an outbound call with a script and voice
Stop In-Progress CallHang up a call that is currently in progress
Cancel Queued CallCancel a call that is queued but has not started dialing
Add LeadCreate a lead and assign it to a list
Update LeadChange fields on an existing lead
Bulk Import LeadsInsert many leads in one call
Start CampaignActivate a campaign so it begins dialing leads
Pause CampaignPause an active campaign without cancelling queued calls
Find Call by IDLook up a single call and return the full record
List Recent CallsReturn the last N calls for your account
Get Account BalanceReturn remaining call minutes and balance details

Supported destinations

Connect Topcalls to dozens of tools across the categories below.

CRM

HubSpot, Salesforce, Pipedrive, Freshdesk, Zendesk

Calendar & scheduling

Google Calendar, Cal.com

Spreadsheets & databases

Google Sheets, Airtable, Notion

Messaging & email

Slack, Discord, Gmail, SendGrid, Mailchimp

Commerce & payments

Stripe, Shopify

Telephony & SMS

Twilio
More destinations are added regularly. If a tool you use isn’t listed, check the integrations catalog inside your dashboard.

Setup walkthrough

1

Open the Integrations tab

Sign in at topcalls.ai and click Integrations in the left sidebar.
2

Pick a destination

Browse the catalog and click the tool you want to connect. Each entry shows the triggers and actions available for that destination.
3

Authorize the connection

Sign in with OAuth or paste an API key, depending on the destination. Topcalls stores credentials encrypted and only uses them for the flows you build.
4

Build your flow

Drag a trigger onto the canvas, add one or more actions, and map the fields between them. The visual editor previews the data at every step.
5

Test with a sample event

Run the flow against a sample event before turning it on for live traffic. Once you’re happy with the result, enable it and the flow runs automatically.

Webhooks vs Integrations

Webhooks deliver call events directly to your endpoint with a JSON payload. Best when you have a backend that can receive and process them.Integrations route the same events through a no-code builder to other tools. Best when you want to push data into a CRM or messaging app without writing code.
You can use both. Webhooks for the systems your engineers own, Integrations for the tools your operations team uses.

Where to next

Webhooks Guide

Set up webhooks, handle payloads, and verify signatures.

Webhooks & Events

Read the event model, available events, and retry semantics.