> ## Documentation Index
> Fetch the complete documentation index at: https://botsify.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={null}
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. |

```json theme={null}
{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGci..."
}
```

> [!NOTE]
>
> Store your `client_id` and `client_secret` securely — you will need them to generate fresh access tokens via the [OAuth Token](/api-reference/authorization/oauth-token.md) endpoint.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.