REST API

Bulk Schedule

Schedule multiple posts at once

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)

Body Parameters

Parameter	Type	Description
`platforms`REQUIRED	`PlatformType[]`	Target platforms for all posts
`timezone`REQUIRED	`string`	IANA timezone for scheduling
`posts`REQUIRED	`PostItem[]`	Array of posts to schedule (1-100)
`twitterConnectionIds`	`string[]`	Twitter account connection IDs
`linkedinConnectionIds`	`string[]`	LinkedIn account connection IDs
`instagramConnectionIds`	`string[]`	Instagram account connection IDs
`tiktokConnectionIds`	`string[]`	TikTok account connection IDs
`youtubeConnectionIds`	`string[]`	YouTube channel connection IDs
`pinterestConnectionIds`	`string[]`	Pinterest account connection IDs
`blueskyConnectionIds`	`string[]`	Bluesky account connection IDs
`threadsConnectionIds`	`string[]`	Threads account connection IDs
`pageIds`	`string[]`	Facebook/LinkedIn page IDs
`pinterestConfigs`	`PinterestConfig[]`	Batch-level Pinterest settings applied to all posts. See Platform Configs for schema
`tiktokConfigs`	`TikTokConfig[]`	Batch-level TikTok settings applied to all posts. See Platform Configs for schema
`instagramConfigs`	`InstagramConfig[]`	Batch-level Instagram settings applied to all posts. See Platform Configs for schema
`facebookConfigs`	`FacebookConfig[]`	Batch-level Facebook settings applied to all posts. See Platform Configs for schema
`youtubeConfigs`	`YouTubeConfig[]`	Batch-level YouTube 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

Parameter	Type	Description
`contentType`REQUIRED	`ContentType`	Content type: TEXT, IMAGE, VIDEO, or CAROUSEL (required)
`text`	`string`	Post text content
`platformTexts`	`PlatformText[]`	Per-platform text overrides
`mediaUrls`	`string[]`	Media file URLs
`thumbnailUrl`	`string`	Thumbnail URL for video posts
`scheduledAt`REQUIRED	`string`	Schedule date (required, ISO 8601)
`pinterestConfigs`	`PinterestConfig[]`	Per-post override. When set, takes priority over the batch-level config for this post
`tiktokConfigs`	`TikTokConfig[]`	Per-post override. When set, takes priority over the batch-level config for this post
`instagramConfigs`	`InstagramConfig[]`	Per-post override. When set, takes priority over the batch-level config for this post
`facebookConfigs`	`FacebookConfig[]`	Per-post override. When set, takes priority over the batch-level config for this post
`youtubeConfigs`	`YouTubeConfig[]`	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.

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"
        }]
      }
    ]
  }'

200

{
  "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
    }
  ]
}

Bulk Schedule

Body Parameters

Post Item Fields

Post Item Parameters

AdaptlyPost

Contact Us