Platforms

Instagram

Instagram is supported via the Instagram Graph API. Connected accounts must be Instagram Business or Creator accounts linked to a Facebook Page. Personal Instagram accounts are not supported by Meta's API and cannot be connected.

Channel ID: instagram

Supported content types

Type	Supported	Notes
Feed post	✅	Single image, video, or carousel (up to 10 items)
Story	✅	Requires media (image or video)
Reel	✅	Requires a vertical video

Minimal example

Code
curl -X POST https://api.omnisocials.com/v1/posts/create \
  -H "Authorization: Bearer $OMNISOCIALS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": { "default": "Golden hour 🌅" },
    "accounts": ["your-instagram-account-id"],
    "media_urls": ["https://example.com/sunset.jpg"]
  }'

Instagram posts always require media. A post with no media returns 400.

Reel options

Set these under the instagram key on the post body when type is reel:

Field	Type	Description
`instagram.share_to_feed`	boolean	Also display the reel on the profile grid
`instagram.thumbnail_type`	string	`from-video` or `from-library`
`instagram.thumb_offset`	number	Timestamp in milliseconds, used when `thumbnail_type` is `from-video`
`instagram.cover_url`	string	URL of a custom cover image, used when `thumbnail_type` is `from-library`

Media requirements

Media	Requirement
Feed image	JPEG or PNG, 320 to 1440 px wide, aspect ratio between 4:5 and 1.91:1
Feed video	MP4 or MOV, up to 90 seconds, max 100 MB
Story image	JPEG or PNG, aspect ratio 9:16 recommended
Story video	MP4, up to 60 seconds, max 100 MB
Reel video	MP4, vertical 9:16, 3 to 90 seconds, max 1 GB
Carousel	2 to 10 items, all images or all videos

Content that violates aspect ratio or duration is rejected at publish time with a 400 error referencing the Instagram Graph API response.

Limitations

Personal (non-business) Instagram accounts cannot be connected
Tagging users in media requires each tagged user to be a public account
Instagram does not allow scheduling posts further than 75 days in advance

Testing

In test mode (omsk_test_* keys), Instagram posts are validated but never sent to Meta. The response shape matches production so your integration can be built and tested without risking real posts.

Last modified on April 10, 2026

Facebook Threads

Type

Supported

Notes

Feed post

✅

Single image, video, or carousel (up to 10 items)

Story

✅

Requires media (image or video)

Reel

✅

Requires a vertical video

Minimal example

Code

curl -X POST https://api.omnisocials.com/v1/posts/create \
  -H "Authorization: Bearer $OMNISOCIALS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": { "default": "Golden hour 🌅" },
    "accounts": ["your-instagram-account-id"],
    "media_urls": ["https://example.com/sunset.jpg"]
  }'

Instagram posts always require media. A post with no media returns 400.

Reel options

Set these under the instagram key on the post body when type is reel:

Field

Type

Description

instagram.share_to_feed

boolean

Also display the reel on the profile grid

instagram.thumbnail_type

string

from-video or from-library

instagram.thumb_offset

number

Timestamp in milliseconds, used when thumbnail_type is from-video

instagram.cover_url

string

URL of a custom cover image, used when thumbnail_type is from-library

Media requirements

Media

Requirement

Feed image

JPEG or PNG, 320 to 1440 px wide, aspect ratio between 4:5 and 1.91:1

Feed video

MP4 or MOV, up to 90 seconds, max 100 MB

Story image

JPEG or PNG, aspect ratio 9:16 recommended

Story video

MP4, up to 60 seconds, max 100 MB

Reel video

MP4, vertical 9:16, 3 to 90 seconds, max 1 GB

Carousel

2 to 10 items, all images or all videos

Content that violates aspect ratio or duration is rejected at publish time with a 400 error referencing the Instagram Graph API response.