Synup
Create a key
v1Resources/Post Ideas/getList post ideas

List post ideas

Returns post ideas in one of three modes: pass locationId for a single location's grid (paginated); pass clientId with scope=locations for the roll-up of location-scoped ideas across a client's locations; or pass clientId with scope=brand for that client's brand-level ideas.

get/api/v1/post-ideas
ideas:read
Query parameters
locationIdstringoptional
List ideas for this location (paginated mode).
clientIdstringoptional
List ideas for this client. Requires scope.
scopestring (locations | brand)optional
Which client-level idea set to return: locations (roll-up across the client's locations) or brand (brand-level ideas).
bucketstring (idea | holiday | calendar | series)optional
Restrict results to one bucket (locationId mode only).
statusstringoptional
Restrict results to one status, or "archived" to list archived ideas instead (locationId mode only).
seriesIdstringoptional
Restrict results to ideas in this content series (locationId mode only).
searchstringoptional
Case-insensitive match against the idea's title (locationId mode only).
pageintegeroptional
Page number, starting at 1. Defaults to 1 (locationId mode only).
perPageintegeroptional
Results per page, up to 50. Defaults to 20 (locationId mode only).
includeRejectedbooleanoptional
Include ideas rejected during approval. Defaults to false (clientId modes only).
Response
dataobjectoptional
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/post-ideas
Your API key
locationId
clientId
scope
bucket
status
seriesId
search
page
perPage
includeRejected
{
  "data": {
    "rows": [
      {
        "id": "cm_idea_abc123",
        "agencyId": "cm_agency_1",
        "locationId": "cm_loc_1",
        "clientLocationId": "cm_loc_1",
        "clientId": null,
        "brandName": null,
        "agentMeta": null,
        "title": "Spotlight our new patient special",
        "content": "Book this month and get 20% off your first cleaning!",
        "imagePrompt": null,
        "imageUrl": null,
        "type": "announcement",
        "status": "draft",
        "bucket": "idea",
        "platforms": [
          "google",
          "facebook"
        ],
        "seriesId": null,
        "scheduledDate": null,
        "scheduledTime": null,
        "observanceName": null,
        "observanceDate": null,
        "generationBatchId": null,
        "generationJobId": null,
        "isUserGenerated": true,
        "source": "os",
        "externalId": "cm_idea_abc123",
        "reviewStatus": null,
        "archived": false,
        "archivedAt": null,
        "createdAt": "2026-01-20T09:00:00.000Z",
        "updatedAt": "2026-01-20T09:00:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "perPage": 20,
    "counts": [
      {
        "bucket": "idea",
        "_count": {
          "id": 4
        }
      }
    ]
  }
}