Posts

Endpointhttps://api.omnisocials.com/v1

Create, read, update, and delete social media posts

List posts

GET

https://api.omnisocials.com/v1

/posts

List posts › query Parameters

status

string · enum

Filter by status

Enum values:

draft

scheduled

posted

failed

limit

integer · max: 100

Number of posts to return

Default: 20

offset

integer

Number of posts to skip

Default: 0

List posts › Responses

200

List of posts

object[]

object

GET/posts

curl --request GET \
  --url https://api.omnisocials.com/v1/posts

shell

Example Responses

{
  "data": [
    {
      "id": "id",
      "status": "draft",
      "type": "post",
      "content": {},
      "accounts": [
        "string"
      ],
      "media": {
        "key": [
          {
            "url": "url",
            "id": "id",
            "channel": "channel"
          }
        ]
      },
      "schedule_at": "2024-08-25T15:00:00Z",
      "published_urls": {},
      "created_at": "2024-08-25T15:00:00Z",
      "approval_status": "approval_status",
      "errors": {},
      "updated_at": "2024-08-25T15:00:00Z"
    }
  ],
  "pagination": {
    "total": 0,
    "limit": 0,
    "offset": 0,
    "has_more": true
  }
}

json

application/json

Get a post by ID

GET

https://api.omnisocials.com/v1

/posts/{id}

Get a post by ID › path Parameters

id

string · required

Post ID

Get a post by ID › Responses

Post details

object

Delete a post

DELETE

https://api.omnisocials.com/v1

/posts/{id}

Delete a post › path Parameters

id

string · required

Delete a post › Responses

Post deleted

No data returned

Update a post

PATCH

https://api.omnisocials.com/v1

/posts/{id}

Update a post › path Parameters

id

string · required

Update a post › Request Body

content

object

accounts

string[]

type

string · enum

Change post type (draft only)

Enum values:

post

story

reel

media

string[]

schedule_at

string · date-time

object

Pinterest-specific options

object

YouTube Shorts options

object

Instagram Reel options

object

TikTok options

object

X (Twitter) options

Update a post › Responses

Post updated

object

PATCH/posts/{id}

curl --request PATCH \
  --url https://api.omnisocials.com/v1/posts/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": {},
  "accounts": [
    "string"
  ],
  "type": "post",
  "media": [
    "string"
  ],
  "schedule_at": "2024-08-25T15:00:00Z",
  "pinterest": {
    "board_id": "board_id",
    "title": "title",
    "link": "link",
    "video_cover": "video_cover"
  },
  "youtube": {
    "title": "title",
    "tags": [
      "string"
    ],
    "privacy_status": "public",
    "category_id": "category_id",
    "made_for_kids": false,
    "notify_subscribers": false,
    "contains_synthetic_media": false
  },
  "instagram": {
    "share_to_feed": false,
    "thumbnail_type": "from-video",
    "thumb_offset": 0,
    "cover_url": "cover_url"
  },
  "tiktok": {
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "disable_comment": false,
    "disable_duet": false,
    "disable_stitch": false,
    "is_aigc": false,
    "brand_content_toggle": false
  },
  "x": {
    "reply_settings": ""
  }
}
'

shell

Example Request Body

{
  "content": {},
  "accounts": [
    "string"
  ],
  "type": "post",
  "media": [
    "string"
  ],
  "schedule_at": "2024-08-25T15:00:00Z",
  "pinterest": {
    "board_id": "board_id",
    "title": "title",
    "link": "link",
    "video_cover": "video_cover"
  },
  "youtube": {
    "title": "title",
    "tags": [
      "string"
    ],
    "privacy_status": "public",
    "category_id": "category_id",
    "made_for_kids": false,
    "notify_subscribers": false,
    "contains_synthetic_media": false
  },
  "instagram": {
    "share_to_feed": false,
    "thumbnail_type": "from-video",
    "thumb_offset": 0,
    "cover_url": "cover_url"
  },
  "tiktok": {
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "disable_comment": false,
    "disable_duet": false,
    "disable_stitch": false,
    "is_aigc": false,
    "brand_content_toggle": false
  },
  "x": {
    "reply_settings": ""
  }
}

json

Example Responses

{
  "data": {
    "id": "id",
    "status": "draft",
    "type": "post",
    "content": {},
    "accounts": [
      "string"
    ],
    "media": {
      "key": [
        {
          "url": "url",
          "id": "id",
          "channel": "channel"
        }
      ]
    },
    "schedule_at": "2024-08-25T15:00:00Z",
    "published_urls": {},
    "created_at": "2024-08-25T15:00:00Z",
    "approval_status": "approval_status",
    "errors": {},
    "updated_at": "2024-08-25T15:00:00Z"
  }
}

json

application/json

Create a new post

POST

https://api.omnisocials.com/v1

/posts/create

Create a new post. You can attach media by uploading first (media/media_ids) or by passing external URLs (media_urls) which will be downloaded and processed automatically. Both can be combined. Note: some platforms require media — Instagram and TikTok posts need at least one image/video, Pinterest posts need an image and a board_id. Posts without required media will be rejected with a 400 error.

Create a new post › Request Body

content

object · required

Post content. Use 'default' for all platforms, or platform-specific keys: instagram, facebook, linkedin, youtube, tiktok, pinterest, x, threads, bluesky, mastodon. Coming soon: google_business, reddit, snapchat.

Example: {"default":"Hello world!","instagram":"Hello from IG! #awesome"}

accounts

string[] · required

Social account IDs to post to. Get IDs from GET /accounts

type

string · enum

Post type: 'post' (feed), 'story' (Instagram/Facebook), 'reel' (Instagram/Facebook/YouTube/TikTok)

Enum values:

post

story

reel

Default: post

Media IDs from POST /media/upload. Flat array or per-platform object.

External image/video URLs to download and attach (max 10 total). Flat array or per-platform object. When using per-platform format, 'default' acts as fallback for selected platforms without their own key.

schedule_at

string · date-time

ISO 8601 datetime to schedule. Omit for draft.

publish_now

boolean

Set true to publish immediately

object

Pinterest-specific options

object

YouTube Shorts options

object

Instagram Reel options

object

TikTok options

object

X (Twitter) options

Create a new post › Responses

Post created

object

POST/posts/create

curl --request POST \
  --url https://api.omnisocials.com/v1/posts/create \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": {
    "default": "Hello world!",
    "instagram": "Hello from IG! #awesome"
  },
  "accounts": [
    "string"
  ],
  "type": "post",
  "media": [
    "string"
  ],
  "media_urls": [
    "https://www.example.com/path/to/resource"
  ],
  "schedule_at": "2024-08-25T15:00:00Z",
  "publish_now": true,
  "pinterest": {
    "board_id": "board_id",
    "title": "title",
    "link": "link",
    "video_cover": "video_cover"
  },
  "youtube": {
    "title": "title",
    "tags": [
      "string"
    ],
    "privacy_status": "public",
    "category_id": "category_id",
    "made_for_kids": false,
    "notify_subscribers": false,
    "contains_synthetic_media": false
  },
  "instagram": {
    "share_to_feed": false,
    "thumbnail_type": "from-video",
    "thumb_offset": 0,
    "cover_url": "cover_url"
  },
  "tiktok": {
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "disable_comment": false,
    "disable_duet": false,
    "disable_stitch": false,
    "is_aigc": false,
    "brand_content_toggle": false
  },
  "x": {
    "reply_settings": ""
  }
}
'

shell

Example Request Body

{
  "content": {
    "default": "Hello world!",
    "instagram": "Hello from IG! #awesome"
  },
  "accounts": [
    "string"
  ],
  "type": "post",
  "media": [
    "string"
  ],
  "media_urls": [
    "https://www.example.com/path/to/resource"
  ],
  "schedule_at": "2024-08-25T15:00:00Z",
  "publish_now": true,
  "pinterest": {
    "board_id": "board_id",
    "title": "title",
    "link": "link",
    "video_cover": "video_cover"
  },
  "youtube": {
    "title": "title",
    "tags": [
      "string"
    ],
    "privacy_status": "public",
    "category_id": "category_id",
    "made_for_kids": false,
    "notify_subscribers": false,
    "contains_synthetic_media": false
  },
  "instagram": {
    "share_to_feed": false,
    "thumbnail_type": "from-video",
    "thumb_offset": 0,
    "cover_url": "cover_url"
  },
  "tiktok": {
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "disable_comment": false,
    "disable_duet": false,
    "disable_stitch": false,
    "is_aigc": false,
    "brand_content_toggle": false
  },
  "x": {
    "reply_settings": ""
  }
}

json

Example Responses

{
  "data": {
    "id": "id",
    "status": "draft",
    "type": "post",
    "content": {},
    "accounts": [
      "string"
    ],
    "media": {
      "key": [
        {
          "url": "url",
          "id": "id",
          "channel": "channel"
        }
      ]
    },
    "schedule_at": "2024-08-25T15:00:00Z",
    "published_urls": {},
    "created_at": "2024-08-25T15:00:00Z",
    "approval_status": "approval_status",
    "errors": {},
    "updated_at": "2024-08-25T15:00:00Z"
  }
}

json

application/json

Create and publish a post immediately

POST

https://api.omnisocials.com/v1

/posts/create-and-publish

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.

Create and publish a post immediately › Request Body

content

object · required

Example: {"default":"Hello world!","instagram":"Hello from IG! #awesome"}

accounts

string[] · required

Social account IDs to post to. Get IDs from GET /accounts

type

string · enum

Post type: 'post' (feed), 'story' (Instagram/Facebook), 'reel' (Instagram/Facebook/YouTube/TikTok)

Enum values:

post

story

reel

Default: post

Media IDs from POST /media/upload. Flat array or per-platform object.

schedule_at

string · date-time

ISO 8601 datetime to schedule. Omit for draft.

publish_now

boolean

Set true to publish immediately

object

Pinterest-specific options

object

YouTube Shorts options

object

Instagram Reel options

object

TikTok options

object

X (Twitter) options

Create and publish a post immediately › Responses

Post created and queued for immediate publishing

object

POST/posts/create-and-publish

curl --request POST \
  --url https://api.omnisocials.com/v1/posts/create-and-publish \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": {
    "default": "Hello world!",
    "instagram": "Hello from IG! #awesome"
  },
  "accounts": [
    "string"
  ],
  "type": "post",
  "media": [
    "string"
  ],
  "media_urls": [
    "https://www.example.com/path/to/resource"
  ],
  "schedule_at": "2024-08-25T15:00:00Z",
  "publish_now": true,
  "pinterest": {
    "board_id": "board_id",
    "title": "title",
    "link": "link",
    "video_cover": "video_cover"
  },
  "youtube": {
    "title": "title",
    "tags": [
      "string"
    ],
    "privacy_status": "public",
    "category_id": "category_id",
    "made_for_kids": false,
    "notify_subscribers": false,
    "contains_synthetic_media": false
  },
  "instagram": {
    "share_to_feed": false,
    "thumbnail_type": "from-video",
    "thumb_offset": 0,
    "cover_url": "cover_url"
  },
  "tiktok": {
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "disable_comment": false,
    "disable_duet": false,
    "disable_stitch": false,
    "is_aigc": false,
    "brand_content_toggle": false
  },
  "x": {
    "reply_settings": ""
  }
}
'

shell

Example Request Body

{
  "content": {
    "default": "Hello world!",
    "instagram": "Hello from IG! #awesome"
  },
  "accounts": [
    "string"
  ],
  "type": "post",
  "media": [
    "string"
  ],
  "media_urls": [
    "https://www.example.com/path/to/resource"
  ],
  "schedule_at": "2024-08-25T15:00:00Z",
  "publish_now": true,
  "pinterest": {
    "board_id": "board_id",
    "title": "title",
    "link": "link",
    "video_cover": "video_cover"
  },
  "youtube": {
    "title": "title",
    "tags": [
      "string"
    ],
    "privacy_status": "public",
    "category_id": "category_id",
    "made_for_kids": false,
    "notify_subscribers": false,
    "contains_synthetic_media": false
  },
  "instagram": {
    "share_to_feed": false,
    "thumbnail_type": "from-video",
    "thumb_offset": 0,
    "cover_url": "cover_url"
  },
  "tiktok": {
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "disable_comment": false,
    "disable_duet": false,
    "disable_stitch": false,
    "is_aigc": false,
    "brand_content_toggle": false
  },
  "x": {
    "reply_settings": ""
  }
}

json

Example Responses

{
  "data": {
    "id": "id",
    "status": "draft",
    "type": "post",
    "content": {},
    "accounts": [
      "string"
    ],
    "media": {
      "key": [
        {
          "url": "url",
          "id": "id",
          "channel": "channel"
        }
      ]
    },
    "schedule_at": "2024-08-25T15:00:00Z",
    "published_urls": {},
    "created_at": "2024-08-25T15:00:00Z",
    "approval_status": "approval_status",
    "errors": {},
    "updated_at": "2024-08-25T15:00:00Z"
  }
}

json

application/json

Publish a post immediately

POST

https://api.omnisocials.com/v1

/posts/{id}/publish

Publish a post immediately › path Parameters

id

string · required

Publish a post immediately › Responses

Post queued for publishing

object

Media

List posts

GET

https://api.omnisocials.com/v1

/posts

List posts › query Parameters

status

string · enum

Filter by status

Enum values:

draft

scheduled

posted

failed

limit

integer · max: 100

Number of posts to return

Default: 20

offset

integer

Number of posts to skip

Default: 0

List posts › Responses

200

List of posts

object[]

object

Update a post

PATCH

https://api.omnisocials.com/v1

/posts/{id}

Update a post › path Parameters

id

string · required

Update a post › Request Body

content

object

accounts

string[]

type

string · enum

Change post type (draft only)

Enum values:

post

story

reel

media

string[]

schedule_at

string · date-time

object

Pinterest-specific options

object

YouTube Shorts options

object

Instagram Reel options

object

TikTok options

object

X (Twitter) options

Update a post › Responses

Post updated

object

Create a new post

POST

https://api.omnisocials.com/v1

/posts/create

Create a new post › Request Body

content

object · required

Example: {"default":"Hello world!","instagram":"Hello from IG! #awesome"}

accounts

string[] · required

Social account IDs to post to. Get IDs from GET /accounts

type

string · enum

Post type: 'post' (feed), 'story' (Instagram/Facebook), 'reel' (Instagram/Facebook/YouTube/TikTok)

Enum values:

post

story

reel

Default: post

Media IDs from POST /media/upload. Flat array or per-platform object.

schedule_at

string · date-time

ISO 8601 datetime to schedule. Omit for draft.

publish_now

boolean

Set true to publish immediately

object

Pinterest-specific options

object

YouTube Shorts options

object

Instagram Reel options

object

TikTok options

object

X (Twitter) options

Create a new post › Responses

Post created

object

Create and publish a post immediately

POST

https://api.omnisocials.com/v1

/posts/create-and-publish

Create and publish a post immediately › Request Body

content

object · required

Example: {"default":"Hello world!","instagram":"Hello from IG! #awesome"}

accounts

string[] · required

Social account IDs to post to. Get IDs from GET /accounts

type

string · enum

Post type: 'post' (feed), 'story' (Instagram/Facebook), 'reel' (Instagram/Facebook/YouTube/TikTok)

Enum values:

post

story

reel

Default: post

Media IDs from POST /media/upload. Flat array or per-platform object.

schedule_at

string · date-time

ISO 8601 datetime to schedule. Omit for draft.

publish_now

boolean

Set true to publish immediately

object

Pinterest-specific options

object

YouTube Shorts options

object

Instagram Reel options

object

TikTok options

object

X (Twitter) options

Create and publish a post immediately › Responses

Post created and queued for immediate publishing

object