---
title: "Authorize new connection"
url: "https://docs.unified.to/unified/integration/Authorize_new_connection"
description: "API reference for Authorize new connection. Launch multiple pre-built Integration integrations today with zero maintenance — all through a single API."
generated_at: "2026-06-03T19:04:31.425Z"
---
# Authorize new connection

 GET/unified/integration/auth/{workspace\_id}/{integration\_type} NO AUTH NEEDED

Returns an authorization URL for the specified integration. Once a successful authorization occurs, a new connection is created.

## Parameters

**success\_redirect**string 

The URL where you want the user to be redirect to after a successful authorization. The connection ID will be appended with (id=<connectionId>) to this URL, as will the state that was provided.

**failure\_redirect**string 

The URL where you want the user to be redirect to after an unsuccessful authentication. An "error" variable will be appended.

**state**string 

Extra state to send back to your success URL

**external\_xref**string 

Your user identifier to associate with the new Integration

**scopes**string array 

**redirect**boolean 

**env**string  default=Production

**lang**string 

Language: en, fr, es, it, pt, zh, hi

**subdomain**string 

Optional tenant domain or subdomain for integrations that require it to build the authorize, token, or API URL. Depending on the integration, this may be a bare subdomain or a full domain/URL.

**region**string 

Optional region index (into the integration api.urls array) selected by the end-user. Set automatically by the auth widget when the workspace integration has prompt\_region=true.

**workspace\_id**string  required 

The ID of the workspace

**integration\_type**string  required 

Type of the supported integration

## Returns

string