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

# Quickstart

> Authenticate, impersonate an organization member, and stay within rate limits.

## Authentication

All API requests require authentication using a Bearer token. To get your API key:

1. **Log in to your Gojiberry AI account** at [https://app.gojiberry.ai](https://app.gojiberry.ai)
2. **Navigate to Settings** → **API** section
3. **Click "Create API Key"** to generate a new token
4. **Copy the API key** when it's displayed (you won't be able to see it again)
5. **Use the token** in your requests by adding the header: `Authorization: Bearer YOUR_API_KEY`

## Impersonation (organization owners)

If your API key belongs to the **owner of an organization**, you can perform any API call on behalf of another member of your organization by adding the `x-impersonate-user-id` header with the member's user ID:

```bash theme={null}
# Get the contacts of the organization member with user ID 123
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "x-impersonate-user-id: 123" \
     https://ext.gojiberry.ai/v1/contact
```

When impersonating, the request behaves exactly as if it was made by that member: you read and write their data (contacts, campaigns, lists, unibox, etc.).

Rules:

* Your API key must belong to the **organization owner**; other members cannot impersonate.
* The impersonated user must belong to the **same organization** as the API key user.
* Requests that don't meet these rules are rejected with a `401 Unauthorized`.

Tip: use `GET /v1/organization/members` to list the members of your organization and their user IDs, and `GET /v1/user/me` to verify which user the current request acts as.

## Rate limits

* **100 requests per minute** per account. Short bursts above this are tolerated.
* **100,000 requests per day** per account.
* Limits are shared by all API keys and AI app (MCP) connections of the same user, including calls made on behalf of organization members with `x-impersonate-user-id`.
* Requests over a limit return `429 Too Many Requests` with a `Retry-After` header (in seconds). Wait that long before retrying.
* Some endpoints have their own lower limit, stated in their description.

## Base URL

**Production:** `https://ext.gojiberry.ai`


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