Skip to main content
As a Plaud Partner on the developer platform, you will need two types of tokens to authenticate to Plaud Embedded:
  1. Partner Token - This is an application-level token you can use to authenticate all of your users.
  2. 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.
app credentials

​
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.
RegionPublic hostStatus
USplatform-us.plaud.ai/developer/apiAvailable
Japanplatform-jp.plaud.ai/developer/apiAvailable
Europeplatform-eu.plaud.ai/developer/apiComing soon
Singaporeplatform-sg.plaud.ai/developer/apiComing 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
}