Skip to main content
Exchange your Botsify credentials for a short-lived OAuth 2.0 Bearer token using the password grant flow. You must first call the Login endpoint to obtain the client_id and client_secret required here. Include the returned access_token in the Authorization: Bearer header of every subsequent API request.

​
Request

​
string
required
The OAuth 2.0 grant type. Must be "password".
​
string
required
Your OAuth client ID, returned by the /api/v1/login endpoint.
​
string
required
Your OAuth client secret, returned by the /api/v1/login endpoint.
​
string
required
Your Botsify account email address.
​
string
required
Your Botsify account password.
​
string
required
The requested OAuth scope. Pass an empty string ("") to request the default scope.

​
Example

​
Response

A successful 200 OK response returns a standard OAuth 2.0 token object.
Use the access_token as Authorization: Bearer <access_token> on all protected endpoints. When the token expires, repeat this request or use the refresh_token to obtain a new one.