Authentication APIs

As a Plaud Partner on the developer platform, you will need two types of tokens to authenticate to Plaud Embedded:

Partner Token - This is an application-level token you can use to authenticate all of your users.
User Token - This is a user-level token used to authenticate their device to your mobile app using the Embedded SDK.

Using the Authentication API

Prerequisites

Use Plaud’s Authentication APIs to retrieve your Partner Token and User Token using your app’s client_id and client_secret found in the developer portal.

Try the Plaud Embedded API Playground to see every step of the transcription process with your own client credentials.End-to-end, from authentication to recording audio to uploading to transcription.

Find Your Region

All partner endpoints — Authentication APIs and Transcription APIs — are served from Plaud’s regional services. There is no global host for these calls; pick the host of the region your client was provisioned in when calling Plaud Embedded APIs.

Region	Public host	Status
US	`platform-us.plaud.ai/developer/api`	Available
Japan	`platform-jp.plaud.ai/developer/api`	Available
Europe	`platform-eu.plaud.ai/developer/api`	Coming soon
Singapore	`platform-sg.plaud.ai/developer/api`	Coming soon

Exchange Credentials for a Partner Token

The Partner Token is an application-level token to issue user-level tokens.

POST [REGION-SPECIFIC-HOST]/oauth/partner/access-token
Authorization: Basic base64(client_id:secret_key)
Content-Type: application/x-www-form-urlencoded

{
  "access_token": "eyJhbGciOiJSUz...",
  "refresh_token": "eyJhbGci...",
  "token_type": "bearer",
  "expires_in": 3600
}

Mint a User Token with Your Partner Token

The User Token is a user-specific token. This token will be used in the Embedded SDK to bind to your users’ devices and upload files.

POST [REGION-SPECIFIC-HOST]/open/partner/users/access-token
Authorization: Bearer <partner_access_token>
Content-Type: application/json

{
  "user_id": "<your stable user id, 6-120 chars>",
  "expires_in": 86400
}

{
  "access_token": "eyJhbGci...",
  "token_type": "bearer",
  "expires_in": 86400
}

Overview

Starter Apps & Guides

Embedded SDK

API

Changelog

Using the Authentication API

Prerequisites

Find Your Region

Exchange Credentials for a Partner Token

Mint a User Token with Your Partner Token

​Using the Authentication API

​Prerequisites

​Find Your Region

​Exchange Credentials for a Partner Token

​Mint a User Token with Your Partner Token

Using the Authentication API

Prerequisites

Find Your Region

Exchange Credentials for a Partner Token

Mint a User Token with Your Partner Token