Skip to main content

​
Base URL

​
Authentication

Most endpoints require a Bearer token. Authentication works in two steps:
  1. Sign in to Boosterberg through a supported authentication endpoint
  2. The server returns a Boosterberg Bearer token - this is the token you use for API calls
Pass the token in the Authorization header:
Endpoints marked as public (presets browsing, geo locations, agency details, reviews) do not require authentication.
Getting your Bearer token for testing: Call POST /user/login-fb, POST /user/signup-fb, or POST /user/login-password. The response includes an access_token field — that’s your Bearer token for all subsequent API calls.

​
Supported Page & Account Types

Boosterberg creates paid ads on behalf of your Facebook and Instagram pages. The following account types are supported:
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.

​
Response Format

Success responses return the data directly — an object, array, boolean, or integer depending on the endpoint. Error responses follow this structure:

​
API Sections

Authentication

Login and signup via Facebook

Campaigns

Create, manage, and monitor boosting campaigns

Posts

View and manage individual boosted posts

Presets

Browse and use campaign templates

Billing

Billing information and invoices

Agencies

Agency directory and management