> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ayrshare

> Ayrshare provides a Social Media API that enables developers to programmatically manage and automate social media posts, analytics, and interactions across multiple platforms.

![Ayrshare logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/ayrshare.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=f5855d6c59176444b6f24c1f4f5b2142)

* **Category:** social media marketing
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 3
* **Triggers:** 0
* **Slug:** `AYRSHARE`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Auto Schedule
>
> **Slug:** `AYRSHARE_CREATE_AUTO_SCHEDULE`
>
> Create an auto-post schedule for the primary profile with specified times and optional weekday filters, for recurring posting plans.
>
> #### Input Parameters
>
> **title** `string`
>
> The title of the schedule. Defaults to 'default'.
>
> **schedule** `array` *required*
>
> List of scheduled times in HH:MMZ format, e.g., \['13:05Z', '22:14Z']
>
> **daysOfWeek** `array`
>
> Optional days of the week to post (0=Sunday ... 6=Saturday). Defaults to every day if omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a previously published Ayrshare post
>
> **Slug:** `AYRSHARE_DELETE_DELETE_POST`
>
> Delete 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
>
> **id** `string`
>
> Ayrshare Post ID to delete. Required if neither `bulk` nor `delete_all_scheduled` is set.
>
> **bulk** `array`
>
> List of Ayrshare Post IDs to delete in bulk. Required if neither `id` nor `delete_all_scheduled` is set.
>
> **markManualDeleted** `boolean`
>
> If true, marks the post as deleted in Ayrshare without calling social APIs. Use when a post was manually removed on the networks.
>
> **deleteAllScheduled** `boolean`
>
> If true, deletes all pending scheduled posts for this profile. Ignores `id` and `bulk` when set.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Post History
>
> **Slug:** `AYRSHARE_GET_POST_HISTORY`
>
> Retrieve 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
>
> **limit** `integer`
>
> Number of records to return per page (default 20; max 500).
>
> **status** `string ("success" | "error" | "processing" | "pending" | "deleted" | "awaiting approval")`
>
> Filter by post status.
>
> **endDate** `string`
>
> End date in ISO 8601 format (inclusive).
>
> **lastDays** `integer`
>
> Return posts from the last X days (default 30; 0 returns all posts).
>
> **startDate** `string`
>
> Start date in ISO 8601 format (inclusive).
>
> **Profile-Key** `string`
>
> Profile Key of a User Profile. Omit to use the primary profile.
>
> **lastRecords** `integer`
>
> Return the last X posts, regardless of date filters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
