---
title: "Create an agent connection setup ticket"
method: POST
path: "/v1/workspaces/{workspaceId}/oauth/setup-ticket"
---

# Create an agent connection setup ticket

`POST /v1/workspaces/{workspaceId}/oauth/setup-ticket`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/oauth/setup-ticket`
- Auth: HTTP bearer

Requires a signed-in human session. API keys and agent credentials cannot authorize this operation.

## Path parameters

- `workspaceId` string, uuid, required

## Request body

- object
  - `entry_surface` 'codex' | 'chatgpt' | 'claude' | 'grok' | 'other_agent', required
  - `client_name` string, required

## Response `201`

Successful response.

- object
  - `data` object, required
    - `mcp_url` string, required
    - `expires_at` string, date-time, required
    - `scopes` string[], required

## Other responses

- `default`: Request failed.

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/a149909267f9?raw)