Skip to main content
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.You may send an empty string ""to publish with no 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.
​
validateScheduled
boolean
default:true
By default, scheduled posts are checked (pre-validated) for issues such as media requirements before they are accepted. If any problems are found by Ayrshare checks, you will receive an immediate error response and the post will not be scheduled. When the scheduled date is reached, the post will be published, at which time the final success or error response will be sent either via webhook or the /history endpoint.To skip this pre-validation step, set validateScheduled to false.We recommend keeping validation enabled for scheduled posts to catch errors early. Otherwise, the post will be scheduled and you will only receive an error when it is published.Please see scheduled webhook actions for more 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
Automatically reposts your content multiple times at regular intervals, creating evergreen content that stays fresh and visible to your audience.See auto repost for details.
​
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.
}
⌘I