Ayrshare provides a Social Media API that enables developers to programmatically manage and automate social media posts, analytics, and interactions across multiple platforms.
Ayrshare provides a Social Media API that enables developers to programmatically manage and automate social media posts, analytics, and interactions across multiple platforms. On Nagent, Ayrshare is exposed as a fully-configurable social media marketing integration that any agent can call — 3 actions, and API key authentication. No code is required to wire Ayrshare into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Ayrshare to automate the kinds of tasks social media marketing teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Ayrshare into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Ayrshare, with input parameters and output schema. Drop these into any step of an agent built in Helix.
AYRSHARE_CREATE_AUTO_SCHEDULETool to create a new auto-post schedule with specified times and optional weekday filters. Use when setting up recurring posting plans.
Input parameters
The title of the schedule. Defaults to 'default'.
List of scheduled times in HH:MMZ format, e.g., \['13:05Z', '22:14Z'\]
Optional days of the week to post (0=Sunday ... 6=Saturday). Defaults to every day if omitted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AYRSHARE_DELETE_DELETE_POSTTool 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.
Input parameters
Ayrshare Post ID to delete. Required if neither `bulk` nor `delete_all_scheduled` is set.
List of Ayrshare Post IDs to delete in bulk. Required if neither `id` nor `delete_all_scheduled` is set.
If true, marks the post as deleted in Ayrshare without calling social APIs. Use when a post was manually removed on the networks.
If true, deletes all pending scheduled posts for this profile. Ignores `id` and `bulk` when set.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
AYRSHARE_GET_POST_HISTORYTool to retrieve Ayrshare post history with metrics. Use when you need to fetch and filter past posts by date, status, or record count.
Input parameters
Number of records to return per page (default 20; max 500).
Filter by post status.
End date in ISO 8601 format (inclusive).
Return posts from the last X days (default 30; 0 returns all posts).
Start date in ISO 8601 format (inclusive).
Profile Key of a User Profile. Omit to use the primary profile.
Return the last X posts, regardless of date filters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 61 agents privately built on Nagent that already use Ayrshare.
Build on Nagent
Connect Ayrshare to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Ayrshare, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Ayrshare is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Ayrshare is connected, you configure its 3 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Ayrshare steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Ayrshare event fires, the agent kicks off automatically.
Every Ayrshare action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Ayrshare ships with 3 pre-built social media marketing actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Ayrshare together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Ayrshare-based workflows tailored to your business.