---
title: "Link app using SS app link token"
method: POST
path: "/{partnerId}/app-link/app-token"
tags: ["Partner app-linking approval"]
---

# Link app using SS app link token

`POST /{partnerId}/app-link/app-token`

## Request

- Base URL: `https://partner.gupshup.io/partner`
- URL: `https://partner.gupshup.io/partner/{partnerId}/app-link/app-token`
- Auth: HTTP bearer

Link an app using an SS-issued app link token (Flow B). No PENDING request is created.

## Path parameters

- `partnerId` integer, required

## Request body

- AppLinkByTokenRequest: Request to link an app using an SS-issued app link token
  - `token` string, required: SS-issued app link JWT

## Response `200`

Success

- PartnerAppLinkByTokenResponse
  - `status` string
  - `linked` boolean
  - `appId` string
  - `appName` string
  - `customerId` string
  - `partnerId` integer
  - `tokenStatus` string

## Other responses

- `400`: Bad Request - invalid token or SS validation failed
- `401`: Unauthorized
- `403`: Forbidden - no permissions to access resource
- `500`: Internal Server Error

---

[API](https://skmtc.dev/gupshup/apis/new-app-linking-apis.md) - [All operations](https://skmtc.dev/gupshup/apis/new-app-linking-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/gupshup/apis/new-app-linking-apis/revisions/1336f06570ad?raw)