Dynamo Developer DocsDynamo Developer Docs
External APICommunityScheduled posts

List scheduled / draft posts

List scheduled and draft posts, soonest-first by `scheduledFor` (undated posts last). Per-channel data appears under `mediumsData`.

get/scheduled-posts

Beta

The External API is in beta. Endpoints, parameters, and response shapes may change — including breaking changes — in future releases. Pin to documented behavior before relying on it in production.

Authorization

x-api-key x-date x-signature x-api-version
x-api-key<token>

Your API key (the ApiKeys document id).

In: header

x-date<token>

Current timestamp as an IMF-fixdate string (GMT, US locale) "EEE, dd MMM yyyy HH:mm:ss z", e.g. "Sun, 06 Dec 2020 12:59:11 GMT". 30-second TTL.

In: header

x-signature<token>

HMAC-SHA256 of the x-date string keyed by your secret, lowercase hex.

In: header

x-api-version<token>

API version you're coding against — currently 1. Required; a missing or unsupported value returns 400 with Missing or unsupported x-api-version header. Supported versions: 1.

In: header

Query Parameters

limit?integer

Max posts to return.

Response Body

application/json

application/json

application/json

application/json

Try it

read-only

Kept in this tab only and signed in your browser — your secret never leaves your device.

Query

Enter your key and secret to send.

curl -X GET "https://example.com/scheduled-posts"
[  {    "_fsDocScope": "MODEL",    "selfPath": "Organization/ORG123/scheduledPublications/AbC123XyZ",    "id": "AbC123XyZ",    "docName": "FsDocScheduledPublication",    "docVer": 1,    "created": {      "_seconds": 1781840702,      "_nanoseconds": 612000000    },    "updated": {      "_seconds": 1781840702,      "_nanoseconds": 612000000    },    "type": "POST",    "media": "https://res.cloudinary.com/demo/image/upload/sample.png",    "mediaType": "IMAGE",    "scheduledFor": "2026-12-01T12:00:00.000Z",    "mediumsData": {      "FB_PAGE_1234567890": {        "caption": "Big launch this weekend — comment FLASH for early access ⚡️",        "mediumType": "FB_PAGE"      }    },    "status": "DRAFT"  }]
{  "message": "string"}
{  "message": "string"}
{  "error": [    {      "message": "string",      "path": [        "string"      ],      "type": "string",      "context": {}    }  ]}

Export a post's stored comments to CSV

Export a post's **stored** comments to a CSV and return `{ totalCount, csvUrl }`. When there are no stored comments, `csvUrl` is `null` and `totalCount` is `0`. `mediumId` is **required**.

Create a draft / scheduled post

Create a draft or submit-ready post. `status` may only be `DRAFT` or `WAITING_FOR_APPROVAL` — never `SCHEDULED` (going live always involves a human in the app). `WAITING_FOR_APPROVAL` runs full publish validation: a future `scheduledFor`, a `media` URL, ≥1 channel, and a caption per channel. Each `channels` key must be a channel id owned by your org; an inline superpower needs a unique `hashtag`, or reference a saved one with `creativeTemplateId`.