Posts
Create and publish post
Changed onCreates a new post and publishes it right away, with no scheduling needed. Equivalent to calling POST /posts/create with publish_now: true. The post will be queued for immediate publishing to all selected platforms.
post/posts/create-and-publish
Request
- Base URLhttps://api.omnisocials.com/v1
- URLhttps://api.omnisocials.com/v1/posts/create-and-publish
- AuthHTTP bearer
Request body
Example request
{
"content": {
"default": "Hello world!",
"instagram": "Hello from IG! #awesome"
},
"accounts": [
"instagram"
],
"media": [
"482913"
],
"media_urls": [
"https://example.com/photo.jpg"
],
"schedule_at": "2026-10-21T09:00:00Z",
"draft": true,
"media_fit": {
"instagram": "keep"
},
"link_url": "https://goodlightai.com/blog/new-feature",
"link_title": "Our autumn menu",
"link_description": "Six new dishes, available from today.",
"link_thumbnail_url": "https://example.com/preview.jpg",
"video_cover": {
"type": "frame",
"thumb_offset": 3000,
"overrides": {
"linkedin_page": {
"type": "custom",
"cover_url": "https://example.com/cover.jpg"
}
}
},
"source": "zapier",
"location_id": "1234567890",
"collaborators": [
"therock",
"kevinhart4real"
],
"user_tags": [
{
"username": "therock",
"x": 0.5,
"y": 0.8
}
],
"hashtag_set": "Fitness Brand",
"hashtag_set_id": "57",
"hashtag_platforms": [
"instagram"
],
"approval_workflow_id": "57823504",
"tags": [
"Question hook",
"Talking head"
],
"comment_dm_automation": {
"trigger": {
"keywords": [
"guide"
]
},
"actions": {
"dm": {
"text": "Here is the guide: https://example.com/guide"
},
"public_reply": {
"enabled": true,
"variations": [
"Sent you a DM!"
]
}
},
"limits": {
"max_sends": 500
}
},
"pinterest": {
"board_id": "1234567890123456789",
"title": "Autumn menu",
"link": "https://example.com/menu",
"video_cover": "https://example.com/cover.jpg",
"alt_text": "A bowl of pumpkin soup on a wooden table",
"product_tags": [
"813744226420795884",
"813744226420795885"
],
"product_tags_result": {
"requested": 2,
"tagged": [
"813744226420795884"
],
"skipped": [
{
"pin_id": "813744226420795885",
"reason": "PIN_IS_PRIVATE"
}
]
}
},
"youtube": {
"title": "How we plan a week of posts",
"tags": [
"social media"
],
"category_id": "22",
"first_comment": "Full menu at the link in our bio."
},
"instagram": {
"thumb_offset": 3000,
"cover_url": "https://example.com/cover.jpg",
"audio_id": "587784541076604",
"first_comment": "Full menu at the link in our bio."
},
"facebook": {
"first_comment": "Full menu at the link in our bio.",
"thumb_offset": 3000,
"cover_url": "https://example.com/cover.jpg"
},
"linkedin": {
"first_comment": "Full menu: https://example.com/menu"
},
"linkedin_page": {
"first_comment": "Full menu: https://example.com/menu"
},
"linkedin_poll": {
"linkedin": {
"question": "Which feature should we build next?",
"options": [
"Bulk upload"
]
},
"linkedin_page": {
"question": "Which feature should we build next?",
"options": [
"Bulk upload"
]
}
},
"tiktok": {
"title": "Autumn menu",
"first_comment": "Full menu at the link in our bio."
},
"x": {
"poll": {
"options": [
"Yes"
]
},
"thread_parts": [
{
"text": "1/3: our results are in",
"media_ids": [
"12345"
]
},
{
"text": "2/3: grab your free pick at https://example.com/signup"
},
{
"text": "3/3: and here's the slip",
"media_ids": [
"12346"
]
}
]
},
"bluesky": {
"thread_parts": [
{
"text": "1/3: our results are in"
},
{
"text": "2/3: read the full writeup at https://example.com/post"
},
{
"text": "3/3: thanks for reading! #buildinpublic"
}
]
},
"mastodon": {
"poll": {
"options": [
"Yes"
]
},
"thread_parts": [
{
"text": "1/3: our picks are in"
},
{
"text": "2/3: read the full writeup at https://example.com/post"
},
{
"text": "3/3: thanks for reading! #fediverse"
}
]
},
"telegram": {
"pin": true,
"buttons": [
{
"text": "See the menu",
"url": "https://example.com/menu"
}
],
"poll": {
"options": [
"Yes"
],
"open_period": 86400
},
"first_comment": "Full menu at the link in our bio."
},
"discord": {
"silent": true,
"link_preview": false,
"buttons": [
{
"text": "Book a table",
"url": "https://example.com/book"
}
]
},
"threads": {
"topic_tag": "Build in public",
"poll": {
"options": [
"Yes"
]
},
"location_id": "17841400000000000",
"location": {
"id": "17841400000000000",
"name": "Griffith Observatory",
"address": "2800 E Observatory Rd",
"city": "Los Angeles",
"country": "United States"
},
"thread_parts": [
{
"text": "1/3: our results are in"
},
{
"text": "2/3: read the full writeup: https://example.com/post"
},
{
"text": "3/3: thanks for reading! #buildinpublic"
}
]
},
"google_business": {
"cta": {
"url": "https://example.com/book"
},
"event": {
"title": "Autumn tasting night",
"schedule": {
"startDate": {
"year": 2026,
"month": 10,
"day": 24
},
"startTime": {
"hours": 18
},
"endDate": {
"year": 2026,
"month": 10,
"day": 24
},
"endTime": {
"hours": 22
}
}
},
"offer": {
"couponCode": "AUTUMN20",
"redeemOnlineUrl": "https://example.com/offer",
"termsConditions": "Valid until 31 October 2026."
}
}
}Response
Post created and queued for immediate publishing
Example response
{
"data": {
"id": "1024",
"content": {
"default": "Our autumn menu is here.",
"instagram": "Our autumn menu is here. #autumnmenu"
},
"accounts": {
"instagram": true,
"linkedin_page": true,
"facebook": false,
"x": false
},
"media": {
"default": [
{
"url": "https://cdn.omnisocials.com/file/library-omnisocials/312a658f-2b45-4289-b240-890807221a74/library/1792573200000-k3j9xq_0c9e6b1a-2f4d-4b8e-a7c3-9d1e5f6a2b70.jpg",
"id": "482913",
"alt": "A bowl of pumpkin soup on a wooden table"
}
]
},
"location_id": "1234567890",
"collaborators": [
"partnerbrand"
],
"user_tags": [
{
"username": "partnerbrand",
"x": 0.5,
"y": 0.8
}
],
"schedule_at": "2026-10-21T09:00:00.000Z",
"app_url": "https://app.omnisocials.com/create-post/1024",
"tags": [
{
"id": 12,
"name": "Question hook"
}
],
"published_urls": {
"facebook": "https://www.facebook.com/123456789/posts/987654321",
"instagram": "https://www.instagram.com/p/Cxyz123ABC/",
"linkedin": "https://www.linkedin.com/feed/update/urn:li:share:7191234567890",
"x": "https://x.com/yourhandle/status/1791234567890123456"
},
"retry_of": "1023",
"retries": [
"1031"
],
"created_at": "2026-10-20T14:32:10.000Z",
"errors": {
"facebook": "Already Posted: These photos were already posted.",
"instagram": "Instagram couldn't accept one of your images. Check that every image is JPEG/PNG, at least 320×320, has an aspect ratio between 4:5 and 1.91:1, and isn't visually flagged by Instagram. Re-upload or replace the offending image and try again."
},
"source": "api",
"updated_at": "2026-10-20T14:35:42.000Z",
"x": {
"poll": {
"options": [
"Yes"
]
},
"thread_parts": [
{
"id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
"text": "1/3: our results are in"
}
]
},
"bluesky": {
"thread_parts": [
{
"id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
"text": "1/3: our results are in"
}
]
},
"mastodon": {
"poll": {
"options": [
"Yes"
]
},
"thread_parts": [
{
"id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
"text": "1/3: our results are in"
}
]
},
"threads": {
"poll": {
"options": [
"Yes"
]
},
"topic_tag": "Build in public",
"location": {
"id": "17841400000000000",
"name": "Griffith Observatory",
"address": "2800 E Observatory Rd",
"city": "Los Angeles",
"country": "United States"
},
"thread_parts": [
{
"id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
"text": "1/3: our results are in"
}
]
},
"telegram": {
"link_preview": true,
"pin": true,
"buttons": [
{
"text": "See the menu",
"url": "https://example.com/menu"
}
],
"poll": {
"options": [
"Yes"
],
"open_period": 86400
},
"result": {
"chat_id": "-1001234567890",
"message_ids": [
"42"
],
"text_message_id": "43",
"pinned": true,
"link_public": "https://t.me/brand/42",
"link_private": "https://t.me/c/1234567890/42",
"sent_at": "2026-10-21T09:00:07.000Z"
}
},
"discord": {
"link_preview": true,
"thread_name": "October menu",
"buttons": [
{
"text": "See the menu",
"url": "https://example.com/menu"
}
],
"poll": {
"options": [
"Yes"
],
"duration_hours": 24
},
"result": {
"webhook_id": "1290000000000000000",
"guild_id": "1180000000000000000",
"channel_id": "1180000000000000001",
"message_id": "1300000000000000000",
"url": "https://discord.com/channels/1180000000000000000/1180000000000000001/1300000000000000000",
"sent_at": "2026-10-22T09:00:03.000Z",
"warnings": [
"media_sent_as_links"
]
}
},
"instagram": {
"first_comment": "Full menu at the link in our bio.",
"first_comment_result": {
"posted_at": "2026-10-21T09:00:07.000Z"
}
},
"video_cover": {
"type": "frame",
"thumb_offset": 3000,
"overrides": {
"linkedin_page": {
"type": "custom",
"cover_url": "https://example.com/cover.jpg"
}
}
},
"facebook": {
"first_comment": "Full menu at the link in our bio.",
"first_comment_result": {
"posted_at": "2026-10-21T09:00:07.000Z"
}
},
"linkedin": {
"first_comment": "Full menu at the link in our bio.",
"first_comment_result": {
"posted_at": "2026-10-21T09:00:07.000Z"
}
},
"linkedin_page": {
"first_comment": "Full menu at the link in our bio.",
"first_comment_result": {
"posted_at": "2026-10-21T09:00:07.000Z"
}
},
"youtube": {
"first_comment": "Full menu at the link in our bio.",
"first_comment_result": {
"posted_at": "2026-10-21T09:00:07.000Z"
}
},
"tiktok": {
"title": "Autumn menu",
"first_comment": "Full menu at the link in our bio.",
"first_comment_result": {
"posted_at": "2026-10-21T09:00:07.000Z"
}
},
"comment_dm_automation": {
"id": "318",
"name": "Guide DM",
"post_id": "1024",
"instagram_media_id": "17912345678901234",
"facebook_post_id": "104857600123456_987654321098765",
"trigger": {
"keywords": [
"guide"
]
},
"actions": {
"dm": {
"text": "Here is the guide: https://example.com/guide"
},
"public_reply": {
"enabled": true,
"variations": [
"Sent you a DM!"
]
}
},
"limits": {
"max_sends": 500,
"stop_at": "2026-11-30T23:00:00.000Z"
},
"stats": {
"matched": 120,
"sent": 112,
"skipped": 6,
"failed": 2,
"last_event_at": "2026-10-21T15:00:12.000Z"
},
"created_at": "2026-10-20T14:32:10.000Z",
"updated_at": "2026-10-20T14:35:42.000Z",
"platforms": [
"instagram",
"facebook"
],
"automations": [
{
"id": "318"
}
]
}
}
}Changes
- info
added the new optional request property
- info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status
- info
- info
added the new optional request property
/ - info
added the optional property
//to the response with the status
- info