POST
/
post
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{
  "post": "Today is a great day!",
  "platforms": ["twitter", "facebook", "instagram", "linkedin"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"]
}' \
-X POST https://api.ayrshare.com/api/post
{
    "status": "success",
    "errors": [],
    "postIds": [
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/bluesky
            "status": "success",
            "id": "at://did:plc:n7atrjd22xgkmgwig6dzlhzd/app.bsky.feed.post/3lez7fwx452", // Bluesky Social Post ID
            "cid": "bafyreie6n475cd3ynr6sfacvohu5qgjibcooxnug6zcbghkwnrwi5stafy",         // Bluesky Content ID
            "postUrl": "https://bsky.app/profile/madworlds.bsky.social/post/3lez7fwx4572",
            "platform": "bluesky"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/facebook
            "status": "success",
            "id": "104923907983682_108329000309742", // Facebook Social Post ID
            "platform": "facebook", 
            "postUrl": "https://www.facebook.com/104923907983682_108329000309742",
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/google
            "status": "success",
            "id": "3837985438581442258", // Google Business Profile Social Post ID
            "postUrl": "https://local.google.com/place?id=5229466225881728772&use=posts&lpsid=CM",
            "type": "localPosts",
            "platform": "gmb"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/instagram
            "status": "success",
            "platform": "instagram", // Instagram Social Post ID
            "id": "17878176260289172",
            "postUrl": "https://www.instagram.com/p/CP1dI9Hp_WO/",
            "usedQuota": 12
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/linkedin
            "status": "success",
            "id": "urn:li:share:7282181682126807041", // LinkedIn Social Post ID
            "postUrl": "https://www.linkedin.com/feed/update/urn:li:share:7282181682126807041",
            "owner": "urn:li:organization:77682157",
            "platform": "linkedin"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/pinterest
            "status": "success",
            "id": "42995371460659062", // Pinterest Social Post ID
            "postUrl": "https://www.pinterest.com/pin/429953714606062/",
            "platform": "pinterest"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/reddit
            "status": "success",
            "id": "1hvdvof", // Reddit Social Post ID
            "postUrl": "https://www.reddit.com/r/test/comments/1hvdvof/reddit_post_title/",
            "platform": "reddit"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/snapchat
            "status": "success",
            "id": "921ed204-e123-5b08-a9ce-zx489f1f38c5",                             // Snapchat Social Post ID 
            "mediaId": "V6noC6UOQgOcABCDEgFZEwAAgd3F0cnp1eWtxZAb9PsH-MXb9PsIWAAAAAA", // Snapchat Media ID
            "postUrl": "https://www.snapchat.com/add/samsmith1920/921ed204-e123-5b08-a9ce-zx489f1f38c5",
            "type": "stories",
            "ended": "2025-05-23T13:04:30.545Z",
            "platform": "snapchat"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/telegram
            "status": "success",
            "id": 635, // Telegram Social Post ID
            "postUrl": "https://t.me/c/1424847122/635",
            "platform": "telegram"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/tiktok
            "status": "success",
            "idShare": "v_pub_url~v2.7456954878846683182",
            "id": "pending", // TikTok Social Post ID - see https://www.ayrshare.com/docs/apis/post/social-networks/tiktok
            "isVideo": true,
            "platform": "tiktok"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/twitter
            "status": "success",
            "id": "1288899996423983105", // X/Twitter Social Post ID
            "platform": "twitter",
            "postUrl": "https://x.com/handle/status/1288899996423983105"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/youtube
            "status": "success",
            "id": "3oQeP-kTsbo", // YouTube Social Post ID
            "postUrl": "https://youtu.be/3oQeP-kTo",
            "platform": "youtube"
        }
    ],
    "id": "RhrbDtYh7hdSMc67zC8H"    // Ayrshare Post ID used for delete, analytics, comments, etc.
}
Available on Basic, Premium, Business, Enterprise plans.

Publish posts to the social networks you or your users have linked. If you want to publish posts to User Profiles, please see the /profiles endpoint for more details.

Please be sure to add your API_KEY, and the PROFILE_KEY if publishing to a User Profile, in the Authorization header. The API Key can be found in the Ayrshare Developer Dashboard under the API Key page.

See the Post API Overview for more details on posting options.

​
Header Parameters

​
Authorization
string
required
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
​
Profile-Key
string
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

​
Body Parameters

​
post
string
required

The post text sent to the social networks specified in the platforms parameter. See here for advanced options, including how to include URLs and rich text.

​
platforms
array
required

Social media platforms to post. Accepts an array of Strings with values: bluesky, facebook, gmb, instagram, linkedin, pinterest, reddit, snapchat, telegram, threads, tiktok, twitter, or youtube.

Please note: use facebook for Facebook Pages, and gmb for Google Business Profile.

Use all to post to all linked social networks. Also include the required fields for all social network. E.g. title must be included in youTubeOptions if youtube is linked.

​
mediaUrls
array

An array of image or video URLs to include in the post. Please see /media endpoint to learn more.

URLs must be secure and begin with https://. If the URL has special characters, e.g. ñ, please encode the special characters before sending.

Videos require a paid plan.

Please see here for Image and Video Requirements and other advanced options.

​
isVideo
boolean
default:false

Ayrshare will try to determine the media type based on the file extension in the URL (.mp4). You can explicitly set the media a video if the URL does not end in a known video extension, such as animated GIFs.

Please see video extension for details.

​
scheduleDate
string

The datetime to schedule a future post. Accepts a UTC date time.

For example, use format YYYY-MM-DDThh:mm:ssZ and send as 2026-07-08T12:30:00Z. Please see utctime for more examples.

Also see schedule posts for details.

​
firstComment
object

Add in a first comment automatically after posting. See first comment for details.

​
disableComments
boolean
default:false

Disable comments for the post. Only available for Instagram, LinkedIn, and TikTok.

​
shortenLinks
boolean
default:false

Shorten links in the post for all platforms using Ayrshare’s link shortener.

Only URLs starting with https will be shortened.

Max Pack required for link shortening.

Please see here for using 3rd party link shorteners.

​
autoSchedule
object

Please see auto-schedule for details.

​
autoRepost
object

Also known as Evergreen Content, automatically repost n times every x days. A paid plan is required.

Parameters:

  • repeat: (required) integer n times, max 10
  • days: (required) integer x times, min 3
  • startDateTime: (optional) as an ISO-8601 UTC date time. If not present, the first post will send immediately.
{
  "repeat": 3,
  "days": 5,
  "startDateTime": "2021-07-08T12:30:00Z"
}

Please be careful when using this capability to stay in compliance with the social networks.

​
autoHashtag
object

See auto hashtags for details.

​
unsplash
string

See unsplash for details.

​
blueskyOptions
object

See Bluesky details.

​
faceBookOptions
object

See Facebook details.

​
gmbOptions
object

See Google Business Profile details.

​
instagramOptions
object

See Instagram details.

​
linkedInOptions
object

See LinkedIn details.

​
pinterestOptions
object

See Pinterest details.

​
redditOptions
object

See Reddit details.

​
snapChatOptions
object

See Snapchat details.

​
telegramOptions
object

See Telegram details.

​
threadsOptions
object

See Threads details.

​
tikTokOptions
object

See TikTok details.

​
twitterOptions
object

See X/Twitter details.

​
youTubeOptions
object

See YouTube details.

​
requiresApproval
boolean
default:false

See approval workflow for details.

​
randomPost
boolean
default:false

Generate random post text for testing. randomPost: true will ignore the post field.

​
randomMediaUrl
boolean
default:false

Generate a random media image for testing. randomMediaUrl: true will ignore the mediaUrls field.

​
idempotencyKey
string

An optional unique ID associated with the post. Duplicate IDs will be rejected. Please see idempotency for details.

​
notes
string

Set notes on a post that can be retrieved via the /history endpoint. Notes are for reference only and do not affect the post.

curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{
  "post": "Today is a great day!",
  "platforms": ["twitter", "facebook", "instagram", "linkedin"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"]
}' \
-X POST https://api.ayrshare.com/api/post
{
    "status": "success",
    "errors": [],
    "postIds": [
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/bluesky
            "status": "success",
            "id": "at://did:plc:n7atrjd22xgkmgwig6dzlhzd/app.bsky.feed.post/3lez7fwx452", // Bluesky Social Post ID
            "cid": "bafyreie6n475cd3ynr6sfacvohu5qgjibcooxnug6zcbghkwnrwi5stafy",         // Bluesky Content ID
            "postUrl": "https://bsky.app/profile/madworlds.bsky.social/post/3lez7fwx4572",
            "platform": "bluesky"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/facebook
            "status": "success",
            "id": "104923907983682_108329000309742", // Facebook Social Post ID
            "platform": "facebook", 
            "postUrl": "https://www.facebook.com/104923907983682_108329000309742",
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/google
            "status": "success",
            "id": "3837985438581442258", // Google Business Profile Social Post ID
            "postUrl": "https://local.google.com/place?id=5229466225881728772&use=posts&lpsid=CM",
            "type": "localPosts",
            "platform": "gmb"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/instagram
            "status": "success",
            "platform": "instagram", // Instagram Social Post ID
            "id": "17878176260289172",
            "postUrl": "https://www.instagram.com/p/CP1dI9Hp_WO/",
            "usedQuota": 12
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/linkedin
            "status": "success",
            "id": "urn:li:share:7282181682126807041", // LinkedIn Social Post ID
            "postUrl": "https://www.linkedin.com/feed/update/urn:li:share:7282181682126807041",
            "owner": "urn:li:organization:77682157",
            "platform": "linkedin"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/pinterest
            "status": "success",
            "id": "42995371460659062", // Pinterest Social Post ID
            "postUrl": "https://www.pinterest.com/pin/429953714606062/",
            "platform": "pinterest"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/reddit
            "status": "success",
            "id": "1hvdvof", // Reddit Social Post ID
            "postUrl": "https://www.reddit.com/r/test/comments/1hvdvof/reddit_post_title/",
            "platform": "reddit"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/snapchat
            "status": "success",
            "id": "921ed204-e123-5b08-a9ce-zx489f1f38c5",                             // Snapchat Social Post ID 
            "mediaId": "V6noC6UOQgOcABCDEgFZEwAAgd3F0cnp1eWtxZAb9PsH-MXb9PsIWAAAAAA", // Snapchat Media ID
            "postUrl": "https://www.snapchat.com/add/samsmith1920/921ed204-e123-5b08-a9ce-zx489f1f38c5",
            "type": "stories",
            "ended": "2025-05-23T13:04:30.545Z",
            "platform": "snapchat"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/telegram
            "status": "success",
            "id": 635, // Telegram Social Post ID
            "postUrl": "https://t.me/c/1424847122/635",
            "platform": "telegram"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/tiktok
            "status": "success",
            "idShare": "v_pub_url~v2.7456954878846683182",
            "id": "pending", // TikTok Social Post ID - see https://www.ayrshare.com/docs/apis/post/social-networks/tiktok
            "isVideo": true,
            "platform": "tiktok"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/twitter
            "status": "success",
            "id": "1288899996423983105", // X/Twitter Social Post ID
            "platform": "twitter",
            "postUrl": "https://x.com/handle/status/1288899996423983105"
        },
        {
            // Details at https://www.ayrshare.com/docs/apis/post/social-networks/youtube
            "status": "success",
            "id": "3oQeP-kTsbo", // YouTube Social Post ID
            "postUrl": "https://youtu.be/3oQeP-kTo",
            "platform": "youtube"
        }
    ],
    "id": "RhrbDtYh7hdSMc67zC8H"    // Ayrshare Post ID used for delete, analytics, comments, etc.
}