Ayrshare
Publish, schedule, analyze, manage, and automate social content across Ayrshare-supported networks.
Tools
| Name | Description |
|---|---|
create_postPublish, schedule, or hold a social post across Ayrshare-supported networks. | Publish, schedule, or hold a social post across Ayrshare-supported networks. |
get_postRetrieve an Ayrshare post by Ayrshare post ID. | Retrieve an Ayrshare post by Ayrshare post ID. |
update_postUpdate a scheduled post date, approval state, pause state, notes, comments setting, or YouTube visibility. | Update a scheduled post date, approval state, pause state, notes, comments setting, or YouTube visibility. |
delete_postDelete a scheduled or published Ayrshare post where the target platform supports deletion. | Delete a scheduled or published Ayrshare post where the target platform supports deletion. |
retry_postRetry a failed Ayrshare post. | Retry a failed Ayrshare post. |
copy_postCopy an existing Ayrshare post to new platforms, optionally scheduled. | Copy an existing Ayrshare post to new platforms, optionally scheduled. |
list_historyList Ayrshare post history with date, status, platform, or limit filters. | List Ayrshare post history with date, status, platform, or limit filters. |
get_history_by_idGet Ayrshare history for one post ID. | Get Ayrshare history for one post ID. |
list_platform_historyList historical posts for one social platform, including posts that did not originate via Ayrshare where supported. | List historical posts for one social platform, including posts that did not originate via Ayrshare where supported. |
get_post_analyticsGet real-time analytics for posts sent via Ayrshare. | Get real-time analytics for posts sent via Ayrshare. |
get_social_analyticsGet analytics and demographics for connected social accounts. | Get analytics and demographics for connected social accounts. |
get_social_post_analyticsGet analytics for a post using the social network post ID. | Get analytics for a post using the social network post ID. |
get_commentsGet comments for a top-level post ID. | Get comments for a top-level post ID. |
create_commentAdd a comment to a published social post. | Add a comment to a published social post. |
reply_to_commentReply to an existing social comment. | Reply to an existing social comment. |
delete_commentsDelete, hide, or bulk-delete comments on a social post where Ayrshare and the platform support it. | Delete, hide, or bulk-delete comments on a social post where Ayrshare and the platform support it. |
upload_mediaUpload an image or small video to Ayrshare media storage and return a URL for posts. | Upload an image or small video to Ayrshare media storage and return a URL for posts. |
list_mediaGet all images and videos uploaded to Ayrshare media storage. | Get all images and videos uploaded to Ayrshare media storage. |
get_media_metadataGet metadata for a media file URL. | Get metadata for a media file URL. |
verify_media_urlVerify that a media file URL exists and is reachable. | Verify that a media file URL exists and is reachable. |
resize_mediaResize an image for social dimensions, watermarking, background blur, conversion, or cropping. | Resize an image for social dimensions, watermarking, background blur, conversion, or cropping. |
get_large_media_upload_urlGet a presigned upload URL for media files larger than 10 MB. | Get a presigned upload URL for media files larger than 10 MB. |
list_profilesList Ayrshare User Profiles under the primary profile. | List Ayrshare User Profiles under the primary profile. |
create_profileCreate a new Ayrshare User Profile under the primary profile. | Create a new Ayrshare User Profile under the primary profile. |
update_profileUpdate an Ayrshare User Profile. | Update an Ayrshare User Profile. |
delete_profileDelete an Ayrshare User Profile by Profile Key or exact title. | Delete an Ayrshare User Profile by Profile Key or exact title. |
generate_profile_jwtGenerate a JWT social-linking URL for an Ayrshare User Profile. | Generate a JWT social-linking URL for an Ayrshare User Profile. |
unlink_social_networkUnlink a social network from a User Profile. | Unlink a social network from a User Profile. |
get_user_profileGet information on the primary or selected Ayrshare User Profile, including linked social networks. | Get information on the primary or selected Ayrshare User Profile, including linked social networks. |
update_userUpdate account or social user data for a platform such as Google Business Profile. | Update account or social user data for a platform such as Google Business Profile. |
get_messagesGet messages or conversations for a messaging platform. | Get messages or conversations for a messaging platform. |
send_messageSend a direct message on Facebook, Instagram, or X/Twitter where enabled by Ayrshare. | Send a direct message on Facebook, Instagram, or X/Twitter where enabled by Ayrshare. |
update_message_conversationUpdate the status of a messaging conversation. | Update the status of a messaging conversation. |
get_auto_responseGet the current message auto-response setting. | Get the current message auto-response setting. |
set_auto_responseSet automatic message response behavior. | Set automatic message response behavior. |
list_reviewsRetrieve reviews for a connected review platform such as Google Business Profile. | Retrieve reviews for a connected review platform such as Google Business Profile. |
get_reviewRetrieve one review. | Retrieve one review. |
reply_to_reviewReply to a review on a connected social account. | Reply to a review on a connected social account. |
delete_review_replyDelete a reply on a review. | Delete a reply on a review. |
register_webhookRegister an Ayrshare webhook URL for an action such as scheduled, social, messages, mentions, comments, feed, batch, or automations. | Register an Ayrshare webhook URL for an action such as scheduled, social, messages, mentions, comments, feed, batch, or automations. |
list_webhooksList registered Ayrshare webhooks. | List registered Ayrshare webhooks. |
unregister_webhookUnregister an Ayrshare webhook associated with an action. | Unregister an Ayrshare webhook associated with an action. |
get_webhook_historyGet Ayrshare webhook delivery history grouped by action. | Get Ayrshare webhook delivery history grouped by action. |
get_facebook_ad_accountsGet connected Facebook ad accounts. | Get connected Facebook ad accounts. |
boost_facebook_postBoost an existing Facebook post through Ayrshare Ads API. | Boost an existing Facebook post through Ayrshare Ads API. |
list_boosted_adsList or retrieve boosted Facebook ads. | List or retrieve boosted Facebook ads. |
update_facebook_adUpdate a boosted Facebook ad status. | Update a boosted Facebook ad status. |
get_facebook_ad_spendGet historical daily Facebook ad spend and analytics. | Get historical daily Facebook ad spend and analytics. |
generate_post_textGenerate AI social post text with Ayrshare. | Generate AI social post text with Ayrshare. |
rewrite_postGenerate variations of a social post. | Generate variations of a social post. |
translate_postTranslate text for a social post. | Translate text for a social post. |
generate_image_alt_textGenerate alt text for an image URL. | Generate alt text for an image URL. |
analyze_sentimentAnalyze sentiment for social text or a comment. | Analyze sentiment for social text or a comment. |
transcribe_videoTranscribe and title a video file using Ayrshare AI utilities. | Transcribe and title a video file using Ayrshare AI utilities. |
recommend_hashtagsRecommend hashtags from a keyword. | Recommend hashtags from a keyword. |
check_banned_hashtagCheck whether an Instagram hashtag is banned. | Check whether an Instagram hashtag is banned. |
search_hashtagsSearch Instagram public media tagged with a hashtag. | Search Instagram public media tagged with a hashtag. |
validate_postValidate a social post JSON payload before publishing. | Validate a social post JSON payload before publishing. |
check_post_lengthCalculate weighted post length for target platforms. | Calculate weighted post length for target platforms. |
custom_api_callMake a custom Ayrshare API call. Non-GET calls require confirmation. | Make a custom Ayrshare API call. Non-GET calls require confirmation. |
Triggers
| Name | Description |
|---|---|
new_history_postPoll Ayrshare history and emit new post records after the initial baseline. | Poll Ayrshare history and emit new post records after the initial baseline. |
post_succeededPoll Ayrshare history and emit new successful post records after the initial baseline. | Poll Ayrshare history and emit new successful post records after the initial baseline. |
post_failedPoll Ayrshare history and emit new failed/error post records after the initial baseline. | Poll Ayrshare history and emit new failed/error post records after the initial baseline. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('ayrshare', 'create_post', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'ayrshare',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Ayrshare to my app?
Use Weavz Hosted Connect for Custom authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Ayrshare support?
Ayrshare supports 60 tools including Create Post, Get Post, Update Post, Delete Post, Retry Post, and more.
Can I use Ayrshare with AI agents?
Yes. Add Ayrshare to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect Ayrshare to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add Ayrshare as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped Ayrshare tools exposed by that workspace.
Does Ayrshare work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved Ayrshare work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with Ayrshare?
Ayrshare exposes 60 tools, including Create Post, Get Post, Update Post, Delete Post, Retry Post, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can Ayrshare be used in stateful agent workflows?
Yes. Agents can combine Ayrshare tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Ayrshare use?
Ayrshare uses Custom. Weavz stores credentials securely and uses them for authorized action execution.
How much does the Ayrshare integration cost?
The Ayrshare integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does Ayrshare support?
Ayrshare supports 3 triggers including New History Post, Post Succeeded, Post Failed.
Connect Ayrshare in minutes
Get 20,000 free action executions every month. No credit card required.