> **Shapeless capabilities index**
> Fetch https://shapelessai.com/llms.txt to discover every page before exploring further.
> Every page also answers Markdown: append `.md` to its path, or send `Accept: text/markdown`.

# Boost with paid

*Verified 2026-10-07. Source: https://shapelessai.com/capabilities/ads*

Propose a paid boost of a published Meta post, read the connected ad accounts, read paid campaign performance and refresh it, and pause, resume, re-budget or delete a Meta campaign (a spend-raising change becomes an approval).

A boost is proposed, not spent: it appears in the inbox and runs only when approved there, so an agent can suggest paid reach without spending a cent on its own.

## Ask in plain words

- "boost the post that is doing well on Instagram"
- "how are the paid campaigns performing"
- "which ad accounts are linked"
- "put twenty dollars behind the Reel for three days"
- "pause the campaign that is burning budget"

## From an agent host (MCP)

No MCP tool yet: call the REST routes below.

## From code (REST)

Bearer API key with the scope each call names ([auth](https://shapelessai.com/docs/auth), [OpenAPI](https://shapelessai.com/api/openapi.json)).

- `POST /api/posts/{id}/boost` (publish scope): Propose a paid boost of a published Meta post.
- `GET /api/ad-accounts` (read scope): Connected ad accounts (identity only).
- `DELETE /api/ad-accounts` (publish scope): Unlink an ad account.
- `GET /api/ads/performance` (read scope): Paid campaign performance.
- `POST /api/ads/refresh` (write scope): Refresh paid campaign data.
- `GET /api/ads/campaigns/{id}` (read scope): One Meta campaign as Meta has it now (status, budget, end date).
- `POST /api/ads/campaigns/{id}` (publish scope): Pause, resume, re-budget or re-date a Meta campaign; spend-raising changes become an approval.
- `DELETE /api/ads/campaigns/{id}` (publish scope): Delete a Meta campaign.

## From a terminal (CLI)

No CLI command yet.

## Example

```bash
curl -s https://shapelessai.com/api/posts/<id>/boost -X POST -H "Authorization: Bearer $SHAPELESS_API_KEY" -H "Content-Type: application/json" -d '{"budgetCents":2000,"days":3}'
```

## Where else

- [Do it in the studio](https://shapelessai.com/studio/performance)