> ## 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

<ParamField body="email" type="string" required>
  The email address associated with your Botsify account.
</ParamField>

<ParamField body="password" type="string" required>
  The password for your Botsify account.
</ParamField>

<ParamField body="agentic-login" type="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.
</ParamField>

## 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) endpoint.
</Note>


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