Documentation

Introduction

Learn how to build and trigger AI voice calls with Twenty2, including assistants, API calls, and call tracking.

Welcome to Twenty2

Twenty2 is an AI voice calling platform that lets you deploy intelligent outbound call agents at scale. Build an assistant once inside the Twenty2 dashboard, then trigger calls programmatically, to one contact or thousands using a simple REST API.

How it works

  1. Build an assistant in the Twenty2 dashboard — define its voice, language, and call script

  2. Publish it and copy its agent_id

  3. Call the API with the assistant ID and the contact's phone number

  4. Track outcomes via webhooks or the call history endpoints

Base URL

https://api.twentytwo.in/api

All requests must be authenticated using a Bearer API key. See the Authentication page to get started.

What you can do with the API

Trigger Outbound Calls

Initiate a single AI-powered call to any number using a published assistant.

Retrieve Call History

Fetch logs, transcripts, and recordings for any past call.

Receive Webhooks

Get notified instantly when a call ends, with full outcome data.

Explore the docs

Quick Start

Get your first call running in 3 steps

API Reference

Full endpoint reference with live playground

Was this page helpful?

Last updated 1 week ago

Built with Documentation.AI