---
title: "Initiate OAuth flow to add a new email connection"
method: POST
path: "/v1/brands/{brandId}/email-connections/authorize"
tags: ["email-connections"]
---

# Initiate OAuth flow to add a new email connection

`POST /v1/brands/{brandId}/email-connections/authorize`

## Request

- Base URL: `https://api.dispatchtickets.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dispatchtickets.com/v1/brands/{brandId}/email-connections/authorize`
- Auth: `bearer` (a scheme the document does not define)

## Path parameters

- `brandId` string, required

## Request body

- InitiateOAuthDto
  - `provider` 'GMAIL' | 'OUTLOOK', required
  - `redirectUrl` string: URL to redirect after OAuth completes
  - `connectionName` string: Display name for the connection (e.g., "Marketing", "Support")

## Response `200`

Returns OAuth authorization URL

---

[API](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api.md) · [All operations](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api/revisions/529e6717d295?raw)