Skip to Content
GrowSocialelion API
Schedule endpoints

Schedule an approved series

Set the publish schedule of an APPROVED series in one call: part 1 at startAt, then one part every everyHours, on the platforms you name per kind.

POST /api/v1/schedule_series · MCP tool schedule_series · scope schedule

Set the publish schedule of an APPROVED series in one call: part 1 at startAt, then one part every everyHours, on the platforms you name per kind. Also plans a 'Part N+1 is live' comment on each part where the network's API allows comments on our own post (YouTube, Instagram, Bluesky, X, Threads, Mastodon); others are listed as unsupported with the reason. Omit `platforms` to use the networks stored on the series. A network that is not connected, needs attention or cannot take that kind of part is refused with a sentence and nothing is scheduled. Every post and article part, and every rendered video, then becomes a draft in the Inbox with its time. Refuses a series a human has not approved. Needs the key's 'schedule' scope.

Scope. Set the schedule of a series a person already approved in the app. This endpoint never costs credits.

Arguments

NameTypeRequiredDescription
seriesIdstringYesFrom propose_series.
startAtstringYesISO date-time of part 1.
everyHoursintegerNoHours between parts.
platformsobjectNoWhere each kind goes, e.g. {video:['youtube','instagram'], article:['devdotto']}. Omitted = the networks stored on the series (the agent's proposal, as the person changed it).
commentsbooleanNoPlan a 'Part N+1 is live' comment on each part where the network allows it. Default: on.

Request

curl -X POST https://growsocialelion.com/api/v1/schedule_series \
  -H "Authorization: Bearer gse_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seriesId":"string","startAt":"2026-11-20T09:00:00.000Z"}'

Response

200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.

{
  "status": "string",
  "reason": "string",
  "seriesId": "string"
}

Errors use the shared body. See Errors. The full schema is in the API reference.