Ayrshare

Ayrshare integration (Social, Marketing). Imported from open-connector.

API key11 toolshttps://api.ayrshare.com/api

GET

ayrshare_get_user_profile

Get Ayrshare account or user profile details, including linked social accounts and usage metadata.

/user

1 parameter

Param	Type	Required	Description
instagramDetails	boolean	optional	Whether Ayrshare should include slower additional Instagram details.

GET

ayrshare_list_post_history

List Ayrshare post history with optional filters for date range, status, type, and social platforms.

/history

8 parameters

Param	Type	Required	Description
limit	integer	optional	The maximum number of history records to return.
platforms	array	optional	The social platforms to include in the history filter.
startDate	string	optional	The inclusive ISO 8601 start date for history results.
endDate	string	optional	The inclusive ISO 8601 end date for history results.
lastDays	integer	optional	The number of previous days to include, or 0 for all history.
status	string	optional	The Ayrshare post status to filter by.
type	string	optional	Whether to return immediate or scheduled posts.
autoRepostId	string	optional	The auto repost ID to filter by, or all for every auto repost.

POST

ayrshare_publish_post

Publish or schedule a social media post through Ayrshare using a JSON-friendly first-pass field set.

/post

8 parameters

Param	Type	Required	Description
post	string	required	The post text to send to the selected social platforms.
platforms	array	required	The social platforms to publish to, or all to publish to every linked platform.
mediaUrls	array	optional	HTTPS image or video URLs to include in the post.
isVideo	boolean	optional	Whether the media URLs should be treated as video media.
scheduleDate	string	optional	The UTC ISO 8601 datetime when Ayrshare should publish the post.
validateScheduled	boolean	optional	Whether Ayrshare should validate a scheduled post before accepting it.
idempotencyKey	string	optional	A unique idempotency key used to reject duplicate post submissions.
notes	string	optional	Internal notes stored with the post and retrievable from history.

GET

ayrshare_get_post

Get one Ayrshare post by top-level Ayrshare post ID, including status and per-platform results.

/post/{id}

1 parameter

Param	Type	Required	Description
id	string	required	The top-level Ayrshare post ID returned by publish_post.

DELETE

ayrshare_delete_post

Delete one or more Ayrshare posts, delete all pending scheduled posts, or mark a post as manually deleted.

/post

4 parameters

Param	Type	Required	Description
id	string	optional	The top-level Ayrshare post ID returned by publish_post.
bulk	array	optional	Ayrshare post IDs to bulk delete.
deleteAllScheduled	boolean	optional	Whether to delete all pending scheduled posts for the profile.
markManualDeleted	boolean	optional	Whether to mark the Ayrshare post as deleted without deleting it from the socia…

PATCH

ayrshare_update_post

Update mutable Ayrshare post metadata such as scheduleDate, approval status, notes, pause state, comments, or YouTube visibility.

/post

7 parameters

Param	Type	Required	Description
id	string	required	The top-level Ayrshare post ID returned by publish_post.
approved	boolean	optional	Whether to approve a post awaiting approval.
disableComments	boolean	optional	Whether to disable comments on supported social platforms.
notes	string	optional	Reference notes stored with the Ayrshare post.
scheduleDate	string	optional	The UTC datetime when Ayrshare should publish the scheduled post.
scheduledPause	boolean	optional	Whether to pause or unpause a scheduled Ayrshare post.
youTubeOptions	object	optional	YouTube metadata to update on a posted video.

PUT

ayrshare_retry_post

Retry an Ayrshare post whose previous publish attempt failed, returning the new pending post status.

/post/retry

1 parameter

Param	Type	Required	Description
id	string	optional	The top-level Ayrshare post ID returned by publish_post.

POST

ayrshare_check_post_length

Check weighted social post length and platform validity using Ayrshare's post length validator.

/post/checkPostWeight

1 parameter

Param	Type	Required	Description
post	string	optional	The post text to measure.

POST

ayrshare_validate_post

Validate an Ayrshare post payload before publishing, including platform and media URL checks.

/validate/post

4 parameters

Param	Type	Required	Description
post	string	required	The post text to validate.
platforms	array	required	The social platforms to validate the post against.
mediaUrls	array	optional	HTTPS image or video URLs to validate with the post.
isVideo	boolean	optional	Whether the media URLs should be treated as video media.

POST

ayrshare_verify_media_url

Verify that a media URL exists and is accessible to Ayrshare.

/media/urlExists

1 parameter

Param	Type	Required	Description
mediaUrl	string	optional	The media URL Ayrshare should verify.

POST

ayrshare_get_post_analytics

Get real-time analytics for an Ayrshare post, optionally limited to selected social platforms.

/analytics/post

2 parameters

Param	Type	Required	Description
id	string	required	The top-level Ayrshare post ID returned by publish_post.
platforms	array	optional	Optional social platforms to include in the Ayrshare request.