REST APIPOST

Bulk Schedule

Schedule up to 100 social media posts at once with platform-specific settings using the AdaptlyPost bulk API endpoint.

POSThttps://post.adaptlypost.com/post/api/v1/social-posts/bulk

Schedule up to 100 posts at once. Each post can have its own content, media, and scheduled time while sharing the same platform connections.

API Key (Bearer token)
Permission:posts.scheduleRoles and permissions

posts.schedule when every item has a future scheduledAt. If any item is dated now or in the past it publishes at once, and the key also needs posts.publish. Contributor and Viewer keys cannot bulk schedule.

Body Parameters

ParameterTypeDescription
platformsREQUIREDPlatformType[]Target platforms for all posts
timezoneREQUIREDstringIANA timezone for scheduling
postsREQUIREDPostItem[]Array of posts to schedule (1-100)
twitterConnectionIdsstring[]Twitter account connection IDs
linkedinConnectionIdsstring[]LinkedIn account connection IDs
instagramConnectionIdsstring[]Instagram account connection IDs
tiktokConnectionIdsstring[]TikTok account connection IDs
youtubeConnectionIdsstring[]YouTube channel connection IDs
pinterestConnectionIdsstring[]Pinterest account connection IDs
blueskyConnectionIdsstring[]Bluesky account connection IDs
mastodonConnectionIdsstring[]Mastodon account connection IDs
googleBusinessConnectionIdsstring[]Google Business Profile location connection IDs
tumblrConnectionIdsstring[]Tumblr blog connection IDs
wordpressConnectionIdsstring[]WordPress site connection IDs
telegramConnectionIdsstring[]Telegram channel and group connection IDs
threadsConnectionIdsstring[]Threads account connection IDs
pageIdsstring[]Facebook pages to post to. Accepts either the account id or the pageId from /social-accounts
pinterestConfigsPinterestConfig[]Batch-level Pinterest settings applied to all posts. See Platform Configs for schema
tiktokConfigsTikTokConfig[]Batch-level TikTok settings applied to all posts. See Platform Configs for schema
instagramConfigsInstagramConfig[]Batch-level Instagram settings applied to all posts. See Platform Configs for schema
facebookConfigsFacebookConfig[]Batch-level Facebook settings applied to all posts. See Platform Configs for schema
youtubeConfigsYouTubeConfig[]Batch-level YouTube settings applied to all posts. See Platform Configs for schema
googleBusinessConfigsGoogleBusinessConfig[]Batch-level Google Business Profile settings applied to all posts. See Platform Configs for schema
tumblrConfigsTumblrConfig[]Batch-level Tumblr settings applied to all posts. See Platform Configs for schema
wordpressConfigsWordPressConfig[]Batch-level WordPress settings applied to all posts. See Platform Configs for schema

Post Item Fields

Each post in the array can have its own content, media, and schedule time.

Post Item Parameters

ParameterTypeDescription
contentTypeREQUIREDContentTypeContent type: TEXT, IMAGE, VIDEO, or CAROUSEL (required)
textstringPost text content. On LinkedIn, mention a company page with @[Page Name](urn:li:organization:<id>), using the page name exactly as LinkedIn shows it. LinkedIn only allows mentions of company pages, not people. GET /api/v1/linkedin-organizations/lookup (see Social Accounts) returns that mention for a page URL or vanity name
platformTextsPlatformText[]Per-platform text overrides
mediaUrlsstring[]Media file URLs
mediaAltTextsstring[]Alt text for each image, in the same order as mediaUrls. Max 1000 characters each; use an empty string to skip an image. Sent to X, Bluesky, Mastodon, Tumblr, WordPress, LinkedIn, Facebook, Instagram and Threads. Pinterest uses the first one, cut to 500 characters. TikTok, YouTube, Google Business Profile and videos ignore it.
thumbnailUrlstringThumbnail of a video post, as an https URL or an image data URI. Every platform that takes a thumbnail uses it unless platformThumbnails overrides it
thumbnailTimestampMsnumberVideo frame to use as the thumbnail, in milliseconds from the start. Works on YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST, TELEGRAM and TIKTOK. A thumbnailUrl sent with it wins everywhere except TIKTOK, which takes only a frame. platformThumbnails overrides both
platformThumbnailsPlatformThumbnail[]A different thumbnail for one platform of a video post, as { platform, thumbnailUrl?, thumbnailTimestampMs? }. YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST and TELEGRAM take an image or a frame, and use the image when both are sent. TIKTOK takes only a frame. Platforms without an entry use thumbnailUrl and thumbnailTimestampMs
platformMediaPlatformMedia[]Its own media for one platform, for when the post media does not fit it, such as a video too long for TikTok or a carousel with more images than X takes. Send { platform, mediaUrls, mediaAltTexts? }, one entry per platform the post goes to. mediaUrls are uploaded https URLs, not data URIs, and must match contentType: one video for VIDEO, one image for IMAGE, one document for DOCUMENT, two or more items for CAROUSEL. TEXT posts take none. mediaAltTexts follows the order of the entry's mediaUrls, max 1000 characters each. The entry is checked against that platform's limits instead of mediaUrls, and the platform takes its thumbnail only from platformThumbnails. Platforms without an entry use mediaUrls
platformAspectRatiosPlatformAspectRatio[]Reframe every image of an IMAGE or CAROUSEL post to one shape on a platform, as { platform, aspectRatio, fit? }. aspectRatio is SQUARE, PORTRAIT, VERTICAL or LANDSCAPE: INSTAGRAM takes SQUARE, PORTRAIT or LANDSCAPE, TIKTOK all four. fit is CROP (default) or PAD. See Create Post
firstCommentsPlatformFirstComment[]A comment posted under the published post from the same account, as { platform, text, delayMinutes }. One entry per platform. LINKEDIN takes up to 1250 characters, TWITTER 280, THREADS 500, BLUESKY 300, MASTODON 500, YOUTUBE 10000 (not on private or made-for-kids videos), FACEBOOK 8000 and INSTAGRAM 2200 (not on stories). Other platforms return a 400. A Facebook Page or Instagram account connected before first comments came to them needs one reconnect; until then its comment fails with firstCommentError. Add delayMinutes (0 to 10080, which is 7 days) to post the comment that many minutes after the platform publishes. Leave it out or send 0 to post it right away. Deleting the post before then cancels the comment
threadRepliesPlatformThreadReplies[]Turns the post into a thread, as { platform, texts, mediaUrls }: the post opens it and each text goes out as a reply to the one before, from the same account. One entry per platform, up to 25 texts. TWITTER takes 280 characters per reply (more on X Premium), THREADS 500, BLUESKY 300 and MASTODON 500 (or the instance limit). mediaUrls is optional and parallel to texts: up to 4 JPEG, PNG, GIF or WEBP images per reply, from POST /upload-urls, and [] for a reply without images. A reply with images may leave its text empty. Other platforms, a reply with neither text nor images, a too long reply, more than 4 images or a video on a reply and a platform that also has a first comment return a 400
scheduledAtREQUIREDstringSchedule date (required, ISO 8601)
pinterestConfigsPinterestConfig[]Per-post override. When set, takes priority over the batch-level config for this post
tiktokConfigsTikTokConfig[]Per-post override. When set, takes priority over the batch-level config for this post
instagramConfigsInstagramConfig[]Per-post override. When set, takes priority over the batch-level config for this post
facebookConfigsFacebookConfig[]Per-post override. When set, takes priority over the batch-level config for this post
youtubeConfigsYouTubeConfig[]Per-post override. When set, takes priority over the batch-level config for this post
googleBusinessConfigsGoogleBusinessConfig[]Per-post override. When set, takes priority over the batch-level config for this post
tumblrConfigsTumblrConfig[]Per-post override. When set, takes priority over the batch-level config for this post
wordpressConfigsWordPressConfig[]Per-post override. When set, takes priority over the batch-level config for this post

Per-Post Platform Config Overrides

Platform configs can be set at two levels: batch-level (applied to all posts as default) and per-post (overrides the batch-level for that specific post). If a post includes its own platform config, it completely replaces the batch-level config for that platform.

Rate Limit

Maximum 100 posts per request. Each post is processed independently, if one fails validation, others will still be scheduled.

One Account per Platform

Only one account per platform is allowed. All posts in the batch share the same connections, so you cannot include multiple connection IDs for the same platform. This restriction is enforced to comply with platform Terms of Service.

Check the batch first

Send the same body to Check Bulk Schedule (POST /api/v1/social-posts/bulk/validate) to get a report for every post before anything is scheduled.
Bulk Schedule Posts
curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/social-posts/bulk \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "platforms": ["YOUTUBE", "PINTEREST"],
    "timezone": "America/New_York",
    "youtubeConnectionIds": ["conn_yt123"],
    "pinterestConnectionIds": ["conn_pin456"],
    "youtubeConfigs": [{
      "connectionId": "conn_yt123",
      "postType": "SHORTS",
      "privacyStatus": "public"
    }],
    "pinterestConfigs": [{
      "connectionId": "conn_pin456",
      "boardId": "board_abc",
      "title": "Default pin title"
    }],
    "posts": [
      {
        "contentType": "VIDEO",
        "text": "First video!",
        "mediaUrls": ["https://cdn.adaptlypost.com/uploads/video1.mp4"],
        "scheduledAt": "2026-03-15T10:00:00Z"
      },
      {
        "contentType": "VIDEO",
        "text": "Second video with custom config",
        "mediaUrls": ["https://cdn.adaptlypost.com/uploads/video2.mp4"],
        "scheduledAt": "2026-03-15T14:00:00Z",
        "youtubeConfigs": [{
          "connectionId": "conn_yt123",
          "postType": "VIDEO",
          "videoTitle": "Full tutorial",
          "privacyStatus": "unlisted"
        }]
      }
    ]
  }'
201
{
  "totalScheduled": 2,
  "totalFailed": 0,
  "results": [
    {
      "postId": "post_abc001",
      "success": true,
      "isScheduled": true,
      "scheduledAt": "2026-03-15T10:00:00Z",
      "errorMessage": null
    },
    {
      "postId": "post_abc002",
      "success": true,
      "isScheduled": true,
      "scheduledAt": "2026-03-15T14:00:00Z",
      "errorMessage": null
    }
  ]
}