---
title: Import Bland AI calls into Agent Analytics
description: "Forward Bland AI voice agent calls, end reasons, a success score, and recording links to Agent Analytics with a scheduled job that pulls from the Bland calls API."
product: general
lang: en
last_updated: 2026-11-05
token_estimate: 995
---
# Import Bland AI calls into Agent Analytics

The Bland AI integration forwards Bland voice calls into Agent Analytics. A scheduled job in your infrastructure lists calls from Bland's API, fetches each call's transcript and outcome, maps it to `[Agent]` events with voice turn properties, and sends them to the Amplitude HTTP API. Amplitude then builds sessions and turns, runs built-in signals, and rolls the voice properties up onto the Session Record.

> For AI agents: a documentation index is available at [/docs/llms.txt](/docs/llms.txt). Append `.md` to any page URL for markdown, or send `Accept: text/markdown`.

## Set up with your AI coding agent (recommended)

Paste this prompt into your AI coding agent, such as Cursor, Claude Code, Windsurf, GitHub Copilot, or Codex. The agent fetches the guide, builds the job, and starts with a dry run.

```text
Connect our Bland AI calls to Amplitude Agent Analytics.

Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/bland.md
If @amplitude/ai is installed, the same file is under node_modules/@amplitude/ai/docs/integrations/.
Follow links in the guide. If your source isn't listed, start at https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/README.md
Follow "Part 2: Coding agent procedure". Start with a dry run.
```

The agent stops and asks for values it can't infer, such as which field holds your user ID and which analysis field records success. Review its changes, then verify with the steps in [Get started](#get-started).

## What this means for you

- **You run**: A job on a schedule, for example every 15 minutes. Run one job per Bland account.
- **You need**: A Bland API key from the Bland dashboard and your Amplitude project API key.
- **Your app must pass**: Your own user ID to Bland as call metadata, so sessions join your product analytics. The job never uses the caller's phone number as a user ID or device ID.

The guide's field mapping comes from Bland's public API reference, not a live Bland account. Confirm the field names against one of your own calls before you rely on them.

## What carries over

| Data | Carries over |
| --- | --- |
| Turns and session grouping | Yes |
| Direction | Yes |
| How the call ended | Yes, as the end-of-turn reason of the last turn |
| Call success | Yes, as an `[Agent] Score` named `call_success`, from a post-call analysis field you choose. Bland has no built-in success field |
| Call recording | Yes, as a link on the last turn, for calls recorded with `record` on, if you choose to send it |
| Speech duration and time to first audio | No. Bland gives each phrase one timestamp and no duration |
| Model, tokens, and cost | No. Bland's price is the whole call's total, not model cost |
| Pathway actions | No, the job skips them |

## Freshness and limits

- **Settle time**: The job reads calls created at least 15 minutes earlier and forwards those that have finished. A call still in progress waits for the next run.
- **Rate limits**: The job makes one request per call and retries requests that return 429 or 5xx, with backoff.
- **Recordings**: The link ships only in `full` [privacy mode](https://amplitude.com/docs/amplitude-ai/agent-analytics/privacy-modes#voice-recordings), and Amplitude never fetches it. Check whether your Bland recording links expire before you send them.

## Get started

Follow the [Bland AI integration guide](https://github.com/amplitude/Amplitude-AI-Node/blob/main/docs/integrations/bland.md). Start with a dry run on a narrow window, check Live Events and the session viewer, then re-run the window to confirm it adds no duplicates. For the voice properties and rollups you get, refer to [Instrument voice agents](https://amplitude.com/docs/amplitude-ai/agent-analytics/voice-agents#analyze-voice-calls).

Guide last verified on November 5, 2026. Bland AI is a trademark of its owner. Amplitude isn't affiliated with or endorsed by Bland AI.

