# Boost Campaign

### Overview

The Boost Campaigns API lets you:

* create boost campaigns for published social posts
* view and manage existing campaigns
* fetch supported ad accounts
* fetch supported countries and interests
* estimate campaign reach
* validate minimum budget requirements
* validate Instagram boost eligibility

These endpoints use the existing MarketingBlocks Bearer token authentication model.

***

### Authentication

**Type:** Bearer Token

```
Authorization: Bearer <token>
```

### Permissions

Depending on the endpoint, the token must include one of these permissions:

* `boost-read-campaigns`
* `boost-create-campaign`
* `boost-view-campaign`
* `boost-update-campaign`
* `boost-delete-campaign`

***

## Possible Errors

| HTTP Status                 | Description                                      |
| --------------------------- | ------------------------------------------------ |
| `401 Unauthorized`          | Missing or invalid bearer token.                 |
| `403 Forbidden`             | Token does not have the required permission.     |
| `404 Not Found`             | Campaign, post, or social account was not found. |
| `422 Unprocessable Entity`  | Validation error in the request body.            |
| `500 Internal Server Error` | Provider-side or unexpected server error.        |

***

## Notes

* Boost campaign creation only works for published social posts.
* The token context determines the active user and project internally.
* Facebook and Instagram boost helper endpoints are Facebook-backed.
* TikTok helper endpoints use TikTok ads account resolution where available.
* Some helper endpoints are intended to support the campaign creation UI flow:
  * ad account selection
  * country selection
  * interest search
  * reach estimate
  * budget validation
  * Instagram eligibility check


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.marketingblocks.ai/agentic-ai-docs/api-reference/social-growth-engine/boost-campaign.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.