NAiOS IconNAiOS Logo
Volver al catálogo

Ayrshare

ayrshare

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

Acciones
4
Triggers
0
Autenticación
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

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ón

Tool 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

  • titlestring

    The title of the schedule. Defaults to 'default'.

  • schedulestring[]Obligatorio

    List 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

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete a previously published Ayrshare postAYRSHARE_DELETE_DELETE_POSTAcción

Tool 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

  • idstring

    Ayrshare 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.

  • markManualDeletedboolean

    If true, marks the post as deleted in Ayrshare without calling social APIs. Use when a post was manually removed on the networks.

  • deleteAllScheduledboolean

    If true, deletes all pending scheduled posts for this profile. Ignores `id` and `bulk` when set.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Post HistoryAYRSHARE_GET_POST_HISTORYAcción

Tool 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

  • limitinteger

    Number of records to return per page (default 20; max 500).

  • statusstringenum

    Filter by post status.

    successerrorprocessingpendingdeletedawaiting approval
  • endDatestring

    End date in ISO 8601 format (inclusive).

  • lastDaysinteger

    Return posts from the last X days (default 30; 0 returns all posts).

  • startDatestring

    Start date in ISO 8601 format (inclusive).

  • Profile-Keystring

    Profile Key of a User Profile. Omit to use the primary profile.

  • lastRecordsinteger

    Return the last X posts, regardless of date filters.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Set Auto ScheduleAYRSHARE_POST_SET_AUTO_SCHEDULEAcción

Tool 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

  • titlestring

    Title for the schedule. Use to reference this schedule in future calls. Defaults to 'default'.

  • schedulestring[]Obligatorio

    Array 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

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not