Publish or schedule a multi-target post
Publish a single body to up to 25 connected accounts in one call, or schedule the whole batch for a future time.
- Multi-target only: the v1 wire shape requires
targets[]. The legacyaccount: {}single-target shape is no longer accepted. - Idempotent: include
Idempotency-Key. Replays within 24 hours return the original response. - Preflight: every documented platform constraint runs locally before the upstream call. Cheap shape preflight is atomic across the batch — if any target fails the synchronous checks the whole call is rejected as
400 preflight_failed. Deep checks (URL reachability, MIME sniffing, byte caps) run per target and surface insideresults[i].error, producing apartial_failedbatch rather than a 400. - Errors: failures use the stable error envelope —
code,rule,platformResponse,remediation,docUrl,ruleUrl.
For per-platform payload differences, see the platforms guides.
Authorizations
Mint an API key in the dashboard. See https://letmepost.dev/docs/authentication/.
Headers
Recommended on every write. Replays within 24 hours return the original response; conflicting bodies surface as 409 idempotency_conflict. See Idempotency.
1 - 128"post-launch-2026-05-15-001"
Body
Multi-target publish request — fans a single body out to up to 25 connected accounts in one call. The legacy single-target account: {} shape is no longer accepted.
Default text applied to any target that omits its own text.
1ISO-8601 timestamp at least 1 second in the future. When set, every target row is queued and the response is 202. Scheduled posts accept text and media (media refs persist and the worker reads them back at fire time); firstComment (rule scheduledAt.no_first_comment) and Bluesky reply threading (rule scheduledAt.no_bluesky_reply) require an immediate publish.
"2026-06-01T12:00:00.000Z"
Response
Immediate publish completed. The batch envelope's status is published (all targets succeeded), partial_failed (mixed outcomes), or failed (every target failed). Per-target detail lives inside results[].
Batch envelope returned by POST /v1/posts. status summarizes the per-target outcomes.
Was this page helpful?

