Save paid ad

Quick save: put one paid ad on the Saved ads board of the credential tenancy.

Last reviewed October 19, 2026Download Markdown ↓

POSThttps://api.peekpanda.com/v1/paid-ads/{platform}/{archiveId}/saved

Request

The command has no request body. The Saved ads board is created on first use. Repeating it returns the same item. To choose boards, use `POST /v1/boards/{boardId}/items`.

Parameters

NameInTypeRequiredDescription

platformpathmeta | tiktokYesAdvertising platform.

archiveIdpathstring, 1–255YesProvider archive id.

Response

The board item on the Saved ads board.

Response fields

idstring

kindstring

platformstring

archiveIdstring

storeIdnull

advertiserNamestring

notenull

addedByUserIdstring

createdAtstring

Authentication

Requires Bearer API credential or OAuth access token. Scope content:write. MCP calls save with action ad.

Errors

400invalid_request for an invalid filter, identity or limit.

401authentication_required for a missing or invalid credential.

402subscription_required when access is not entitled.

403authorization_required for a missing scope or unavailable preview access.

403workspace_not_accessible when x-genviral-tenancy names a workspace the credential cannot reach.

404not_found when the record is outside the accessible catalogue.

429rate_limited; honor Retry-After when present.

429daily_call_limit; the plan's daily API and MCP calls are used until 00:00 UTC.

409conflict when the write would duplicate an exclusive row.

MCP request

Call save with action ad. Path fields go in params, filters in query, and a write body in body.

{
  "name": "save",
  "arguments": {
    "request": {
      "action": "ad",
      "params": {
        "platform": "<platform>",
        "archiveId": "<archiveId>"
      }
    }
  }
}

Source

Board items on stored Meta/TikTok ad-library observations. Not Apple.

Refresh

Save and unsave change board items only and never start collection.

AI agent or LLM? Read this page as markdown