List marketing posts

GET /v1/marketing/posts

Scope marketing:read. The shop's social posts and website articles, newest first: what each says, where it goes, its state, and once posted how many saw it, clicked and booked.

Parameter	Type	Required	Description
status	string	no	suggested, draft, scheduled, posted, skipped or expired. suggested and draft are the ones waiting for the owner
search	string	no	Words in the title or text
limit	integer	no	1 to 50. Default 20

{
  "data": {
    "posts": [
      {
        "id": 418,
        "title": "Spots left this Saturday",
        "status": "posted",
        "kind": "social",
        "channels": ["facebook", "instagram"],
        "date": "2026-10-03",
        "seen_by": 1240,
        "clicks": 38,
        "bookings": 4,
        "body": "A few spots are still open for Saturday afternoon..."
      }
    ],
    "waiting": 3
  }
}

seen_by and clicks are null until the service reports them. bookings is null for a post that has not gone out. kind is social or article (an article goes to the shop's News page).

Posts are made and approved in the Marketing suite, by Dash, or over MCP.