---
title: "Exchange a magic link token for a session"
method: GET
path: "/v2/bot_sessions"
tags: ["Bot Signup"]
---

# Exchange a magic link token for a session

`GET /v2/bot_sessions`

Consumes the one-time portal redirect (magic link) token emailed during bot signup and returns an API session. The token is a UUIDv7 that encodes its creation time; it expires after a configurable validity window (15 minutes by default) and is cleared on first use. Although the action creates a session, the route uses the GET verb because it is opened from an email link. On first use the account is also initialized. For bot signup (freemium) accounts the response is a minimal envelope containing only the `api_v2_token`; accounts that are permitted to use magic links but are not freemium accounts may instead receive an extended session payload when additional steps (such as two-factor authentication or identity verification) are required. This endpoint is public; the magic link token in the query string is the credential.

## Query parameters

- `email` string, email, required
- `portal_redirect_token` string, uuid, required

## Response `200`

Session created. Bot signup accounts receive a minimal token envelope.

- BotSessionResponse
  - `data` object, required
    - `api_v2_token` string, required — API v2 session token for the signed-in user. Use it as a bearer token on authenticated endpoints.

## Other responses

- `400` — The account could not be initialized.
- `401` — Missing or invalid email or token, expired token, or the account is not eligible to sign in (inactive, suspended, not permitted to use magic links, or must use SSO).
- `403` — Request blocked by security policy (for example, the caller's country is not accepted).
- `404` — Bot signup is not available (freemium master switch disabled or the caller's country is not enabled).

## Changes

> 78 revisions in range; 1 not diffed.

- **2026-09-16** `a6a61a29ecdd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/v2/bot_sessions/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/950384d11a37?raw)