Login — Authenticate with Botsify and Get API Keys

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

string

required

The email address associated with your Botsify account.

string

required

The password for your Botsify account.

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": "you@example.com",
    "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.

Authorization

Bots & Agents

Agent Versions

Messaging

Users & Analytics

WhatsApp

Login — Authenticate with Botsify and Get API Keys

Request

Example

Response

​Request

​Example

​Response

Request

Example

Response