---
title: "Authorize"
method: GET
path: "/vault/authorize/{service_id}/{application_id}"
tags: ["Connections"]
---

# Authorize

`GET /vault/authorize/{service_id}/{application_id}`

__In most cases the authorize link is provided in the ``/connections`` endpoint. Normally you don't need to manually generate these links.__

Use this endpoint to authenticate a user with a connector. It will return a 301 redirect to the downstream connector endpoints.

Auth links will have a state parameter included to verify the validity of the request. This is the url your users will use to activate OAuth supported integration providers.

Vault handles the complete Authorization Code Grant Type Flow for you and will redirect you to the dynamic redirect uri you have appended to the url in case this is missing the default redirect uri you have configured for your Unify application.

## Path parameters

- `service_id` string, required
- `application_id` string, required

## Query parameters

- `state` string, required
- `redirect_uri` string, required
- `scope` string[]

## Response `default`

Unexpected error

- UnexpectedErrorResponse
  - `status_code` number — HTTP status code
  - `error` string — Contains an explanation of the status_code as defined in HTTP/1.1 standard (RFC 7231)
  - `type_name` string — The type of error returned
  - `message` string — A human-readable message providing more details about the error.
  - `detail` union — Contains parameter or domain specific information related to the error and why it occurred.
    - string
    - object
  - `ref` string — Link to documentation of error type

## Other responses

- `301` — redirect
- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `404` — The specified resource was not found
- `422` — Unprocessable

## Changes

- **2026-04-09** `79ff7820cc6f` — 1 warning
  - deleted the `query` request parameter `nonce`

[Change history](https://skmtc.dev/apideck-libraries/apis/vault-api/changes/vault/authorize/:service_id/:application_id/get.md)

---

[API](https://skmtc.dev/apideck-libraries/apis/vault-api.md) · [All operations](https://skmtc.dev/apideck-libraries/apis/vault-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apideck-libraries/vault-api/revisions/d4e6d578ea4c/schema)