Skip to main content
Ayrshare logo
  • Category: social media marketing
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 3
  • Triggers: 0
  • Slug: AYRSHARE
  • Version: 20261101_00

Tools

Slug: AYRSHARE_CREATE_AUTO_SCHEDULECreate an auto-post schedule for the primary profile with specified times and optional weekday filters, for recurring posting plans.

Input Parameters

string
The title of the schedule. Defaults to ‘default’.
array
required
List of scheduled times in HH:MMZ format, e.g., [‘13:05Z’, ‘22:14Z’]
array
Optional days of the week to post (0=Sunday … 6=Saturday). Defaults to every day if omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AYRSHARE_DELETE_DELETE_POSTDelete published or scheduled Ayrshare posts on the primary profile by post ID, in bulk, or by selecting all pending scheduled posts. Instagram and TikTok published posts cannot be deleted via API; posts removed manually can be marked deleted in Ayrshare.

Input Parameters

string
Ayrshare Post ID to delete. Required if neither bulk nor delete_all_scheduled is set.
array
List of Ayrshare Post IDs to delete in bulk. Required if neither id nor delete_all_scheduled is set.
boolean
If true, marks the post as deleted in Ayrshare without calling social APIs. Use when a post was manually removed on the networks.
boolean
If true, deletes all pending scheduled posts for this profile. Ignores id and bulk when set.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: AYRSHARE_GET_POST_HISTORYRetrieve Ayrshare post history, filtering by date, status, or record count. A user profile can be selected by explicitly supplying its profile key; otherwise the primary profile is used.

Input Parameters

integer
Number of records to return per page (default 20; max 500).
string ("success" | "error" | "processing" | "pending" | "deleted" | "awaiting approval")
Filter by post status.
string
End date in ISO 8601 format (inclusive).
integer
Return posts from the last X days (default 30; 0 returns all posts).
string
Start date in ISO 8601 format (inclusive).
string
Profile Key of a User Profile. Omit to use the primary profile.
integer
Return the last X posts, regardless of date filters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not