Ayrshare
ayrshareAyrshare provides a Social Media API that enables developers to programmatically manage and automate social media posts, analytics, and interactions across multiple platforms.
Acciones disponibles (4)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Create Auto ScheduleAYRSHARE_CREATE_AUTO_SCHEDULEAcciónTool to create a new auto-post schedule with specified times and optional weekday filters. use when setting up recurring posting plans.
AYRSHARE_CREATE_AUTO_SCHEDULEAcciónTool to create a new auto-post schedule with specified times and optional weekday filters. use when setting up recurring posting plans.
Parámetros de entrada
titlestringThe title of the schedule. Defaults to 'default'.
schedulestring[]ObligatorioList of scheduled times in HH:MMZ format, e.g., ['13:05Z', '22:14Z']
daysOfWeekinteger[]Optional days of the week to post (0=Sunday ... 6=Saturday). Defaults to every day if omitted.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete a previously published Ayrshare postAYRSHARE_DELETE_DELETE_POSTAcciónTool to delete an ayrshare post. use when you need to remove a published or scheduled post by its ayrshare post id, after confirming the correct id. note: instagram and tiktok published posts cannot be deleted via api; set `mark manual deleted=true` or remove manually.
AYRSHARE_DELETE_DELETE_POSTAcciónTool to delete an ayrshare post. use when you need to remove a published or scheduled post by its ayrshare post id, after confirming the correct id. note: instagram and tiktok published posts cannot be deleted via api; set `mark manual deleted=true` or remove manually.
Parámetros de entrada
idstringAyrshare Post ID to delete. Required if neither `bulk` nor `delete_all_scheduled` is set.
bulkstring[]List of Ayrshare Post IDs to delete in bulk. Required if neither `id` nor `delete_all_scheduled` is set.
markManualDeletedbooleanIf true, marks the post as deleted in Ayrshare without calling social APIs. Use when a post was manually removed on the networks.
deleteAllScheduledbooleanIf true, deletes all pending scheduled posts for this profile. Ignores `id` and `bulk` when set.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Post HistoryAYRSHARE_GET_POST_HISTORYAcciónTool to retrieve ayrshare post history with metrics. use when you need to fetch and filter past posts by date, status, or record count.
AYRSHARE_GET_POST_HISTORYAcciónTool to retrieve ayrshare post history with metrics. use when you need to fetch and filter past posts by date, status, or record count.
Parámetros de entrada
limitintegerNumber of records to return per page (default 20; max 500).
statusstringenumFilter by post status.
successerrorprocessingpendingdeletedawaiting approvalendDatestringEnd date in ISO 8601 format (inclusive).
lastDaysintegerReturn posts from the last X days (default 30; 0 returns all posts).
startDatestringStart date in ISO 8601 format (inclusive).
Profile-KeystringProfile Key of a User Profile. Omit to use the primary profile.
lastRecordsintegerReturn the last X posts, regardless of date filters.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Set Auto ScheduleAYRSHARE_POST_SET_AUTO_SCHEDULEAcciónTool to set up an auto-post schedule with specified times and optional weekday filters. use when scheduling posts around a recurring pattern.
AYRSHARE_POST_SET_AUTO_SCHEDULEAcciónTool to set up an auto-post schedule with specified times and optional weekday filters. use when scheduling posts around a recurring pattern.
Parámetros de entrada
titlestringTitle for the schedule. Use to reference this schedule in future calls. Defaults to 'default'.
schedulestring[]ObligatorioArray of scheduled times in ISO-8601 UTC format 'HH:MMZ', e.g., ['13:05Z', '22:14Z']
daysOfWeekinteger[]Optional days of the week to post (0=Sunday...6=Saturday). Defaults to all days if omitted.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not