REST API
Create Post
Publish or schedule a post across multiple platforms
POST
https://api.adaptlypost.com/api/v1/social-postsCreate a new social media post. Posts can be published immediately, scheduled for later, or saved as drafts.
API Key (Bearer token)
Body Parameters
| Parameter | Type | Description |
|---|---|---|
platformsREQUIRED | PlatformType[] | Target platforms (e.g. TWITTER, LINKEDIN, INSTAGRAM) |
contentTypeREQUIRED | ContentType | TEXT, IMAGE, VIDEO, or CAROUSEL |
text | string | Post text content |
platformTexts | PlatformText[] | Per-platform text overrides |
mediaUrls | string[] | URLs of uploaded media files |
thumbnailUrl | string | Thumbnail URL for video posts |
scheduledAt | string | ISO 8601 date for scheduling. Omit to publish immediately. |
timezoneREQUIRED | string | IANA timezone (e.g. America/New_York) |
saveAsDraft | boolean | Save as draft instead of publishing |
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 |
Platform-Specific Text
Use platformTexts to customize content per platform while sharing the same post.
When a platform has no entry in platformTexts, the default text field is used.
One account per platform
Only one account per platform is allowed per post. For example, you cannot include two Twitter connection IDs in the same request. This restriction is enforced to comply with platform Terms of Service. Violating this rule will return a 400 error.