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

# Introduction

> Boosterberg REST API for managing campaigns, posts, presets, and more

## Base URL

```
https://api.boosterberg.com/v1
```

Beta environment:

```
https://api.boosterberg.com-beta.com/v1
```

## Authentication

Most endpoints require a Bearer token. Authentication works in two steps:

1. **Sign in to Boosterberg** via Facebook (the only login method currently available)
2. **The server exchanges your Facebook token** for a Boosterberg-specific Bearer token — this is the token you use for all API calls

Pass the token in the `Authorization` header:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.boosterberg.com/v1/user/detail
```

Endpoints marked as public (presets browsing, geo locations, agency details, reviews) do not require authentication.

<Tip>
  **Getting your Bearer token for testing:** Call `POST /user/login-fb` or `POST /user/signup-fb` with a valid Facebook access token. The response includes an `access_token` field — that's your Bearer token for all subsequent API calls.
</Tip>

## Supported Page & Account Types

Boosterberg creates paid ads on behalf of your Facebook and Instagram pages. The following account types are supported:

| Platform      | Account Type                                          | Supported |
| ------------- | ----------------------------------------------------- | --------- |
| **Facebook**  | Business Page                                         | Yes       |
| **Facebook**  | Personal Profile                                      | No        |
| **Instagram** | Business Account (linked to a Facebook Business Page) | Yes       |
| **Instagram** | Creator Account                                       | No        |
| **Instagram** | Personal Account                                      | No        |

<Note>
  Instagram accounts must be **Business Accounts** connected to a Facebook Business Page. Personal and Creator Instagram accounts cannot be used because the Meta Ads API requires a Business Page linkage to run promotions.
</Note>

## Response Format

**Success** responses return the data directly — an object, array, boolean, or integer depending on the endpoint.

**Error** responses follow this structure:

```json theme={null}
{
  "name": "Bad Request",
  "message": "Description of what went wrong",
  "code": "ERROR_CODE",
  "status": 400
}
```

## API Sections

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-reference/endpoint/auth/login-fb">
    Login and signup via Facebook
  </Card>

  <Card title="Campaigns" icon="bullhorn" href="/api-reference/endpoint/campaigns/list">
    Create, manage, and monitor boosting campaigns
  </Card>

  <Card title="Posts" icon="newspaper" href="/api-reference/endpoint/posts/list">
    View and manage individual boosted posts
  </Card>

  <Card title="Presets" icon="sliders" href="/api-reference/endpoint/presets/browse">
    Browse and use campaign templates
  </Card>

  <Card title="Billing" icon="credit-card" href="/api-reference/endpoint/billing/detail">
    Billing information and invoices
  </Card>

  <Card title="Agencies" icon="building" href="/api-reference/endpoint/agencies/list">
    Agency directory and management
  </Card>
</CardGroup>