Posts
Create and publish a post immediately
Creates a new post and publishes it right away — 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 body
Example request
{
"content": {
"default": "Hello world!",
"instagram": "Hello from IG! #awesome"
},
"media_urls": {
"default": [
{
"url": "https://example.com/photo.jpg",
"alt": "A red bicycle leaning against a brick wall"
}
],
"instagram": [
"https://example.com/square.jpg"
]
},
"link_url": "https://goodlightai.com/blog/new-feature",
"location_id": "1234567890",
"collaborators": [
"therock",
"kevinhart4real"
],
"user_tags": [
{
"username": "therock",
"x": 0.5,
"y": 0.8
}
],
"hashtag_set": "Fitness Brand",
"instagram": {
"audio_id": "587784541076604"
},
"x": {
"thread_parts": [
{
"text": "1/3 — our results are in 👇",
"media_ids": [
"12345"
]
},
{
"text": "2/3 — grab your free pick here: 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: https://example.com/post"
},
{
"text": "3/3 — thanks for reading! #buildinpublic"
}
]
},
"mastodon": {
"thread_parts": [
{
"text": "1/3 — our picks are in 👇"
},
{
"text": "2/3 — read the full writeup: https://example.com/post"
},
{
"text": "3/3 — thanks for reading! #fediverse"
}
]
},
"threads": {
"location_id": "17841400000000000",
"location": {
"id": "17841400000000000",
"name": "Griffith Observatory",
"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"
}
]
}
}Response
Post created and queued for immediate publishing
Example response
{
"data": {
"app_url": "https://app.omnisocials.com/create-post/1024",
"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"
},
"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."
},
"threads": {
"location": {
"id": "17841400000000000",
"name": "Griffith Observatory",
"city": "Los Angeles",
"country": "United States"
}
}
}
}Changes
No recorded changes to this endpoint across all 1 revision of this API.