ShapelessAIAll capabilities
Signal

Boost with paid

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).

View as Markdown

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, OpenAPI).

  • 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

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

Every capability · Docs · /llms.txt