Login — Authenticate with Botsify and Get API Keys

Authenticate with your Botsify email and password to receive your OAuth client_id, client_secret, and an optional Bearer access token.

Authenticate with your Botsify account by submitting your email and password. The response returns the client_id and client_secret needed for the OAuth token flow, and — when agentic-login is set to true — a ready-to-use Bearer access_token suitable for agentic or MCP clients.

Request

email · string · required

The email address associated with your Botsify account.

password · string · required

The password for your Botsify account.

agentic-login · boolean

When true, the response includes a Bearer access_token that can be used directly by agentic or MCP clients without a separate OAuth token exchange.

Example

curl --request POST \
  --url https://app.botsify.com/api/v1/login \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "[e-mail]",
    "password": "yourpassword",
    "agentic-login": true
  }'

Response

A successful 200 OK response returns a JSON object containing your OAuth credentials and, if agentic-login was true, a Bearer access token.

Field	Type	Description
client_id	string	Your OAuth client ID. Pass this to the /oauth/token endpoint.
client_secret	string	Your OAuth client secret. Pass this to the /oauth/token endpoint.
access_token	string	Bearer token returned when agentic-login is true. Use in the Authorization: Bearer header for subsequent API calls.

{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGci..."
}

Store your client_id and client_secret securely — you will need them to generate fresh access tokens via the OAuth Token endpoint.