Package Information
Documentation
@agorapulse/n8n-nodes-agorapulse
This is an n8n community node that lets you use Agorapulse in your n8n workflows.
Agorapulse is a social media management platform that helps businesses and agencies manage their social media presence, engage with their audience, and publish content across multiple networks.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Installation
Follow the installation guide in the n8n community nodes documentation.
Community Nodes (Recommended)
- Go to Settings > Community Nodes in your n8n instance
- Select Install
- Enter
@agorapulse/n8n-nodes-agorapulsein the npm Package Name field - Select Install
Manual Installation
To get started, install the package in your n8n root directory:
npm install @agorapulse/n8n-nodes-agorapulse
For Docker-based deployments, add the package to your n8n Docker image.
Operations
Actions
- Create Note: Create a new note on the publishing calendar with specified dates and profiles
- Create Draft: Create a new post draft with content, scheduling information, and media
Searches
- List Organizations: Retrieve all organizations that the authenticated user has access to
- List Workspaces: Retrieve all workspaces within a specified organization
- List Profiles: Retrieve all social media profiles available in a workspace
- List Conversation Messages: Retrieve messages from an inbox conversation with optional filtering
Triggers
- Publishing Post Trigger: Triggers when a post is published or fails to publish on a social network
- Inbox Item Trigger: Triggers when a new inbox item is received or when an existing item's labels or sentiment analysis are modified
Credentials
To use this node, you need an Agorapulse API Key:
- Log in to your Agorapulse account
- Navigate to Settings > Personal > Open API (https://app.agorapulse.com/(settings:personal/open-api))
- Generate a new API key
- Copy the API key
In n8n:
- Go to Credentials > New
- Search for Agorapulse API
- Paste your API key
- Select the environment (Production recommended)
- Click Create to save
The credentials will be automatically tested by attempting to fetch your organizations.
Compatibility
- Tested with n8n version 1.x
- Minimum n8n version: 1.0.0
Usage
Example 1: Create a Calendar Note
- Add the Agorapulse node to your workflow
- Select Action as the resource
- Select Create Note as the operation
- Choose your Organization from the dropdown
- Choose your Workspace from the dropdown
- Enter a Title for the note
- Select a Color
- Set Start Date and End Date
- Optionally select Profiles to associate with the note
- Optionally add a Body description
Example 2: Create a Draft Post
- Add the Agorapulse node to your workflow
- Select Action as the resource
- Select Create Draft as the operation
- Choose your Organization from the dropdown
- Choose your Workspace from the dropdown
- Select the post Type (Text, Photo, Video, etc.)
- Enter the Text content
- Optionally add Link, Labels, Media URLs
- Select Profiles where the post will be published
- Optionally set Publishing Dates to schedule the post
Example 3: Monitor Published Posts
- Add the Agorapulse Publishing Post Trigger node to your workflow
- Choose your Organization from the dropdown
- Connect subsequent nodes to process the webhook data
- Activate the workflow
The trigger will fire whenever a post is published or fails to publish in the selected organization.
Example 4: Monitor Inbox Items
- Add the Agorapulse Inbox Item Trigger node to your workflow
- Choose your Organization from the dropdown
- Connect subsequent nodes to process incoming messages
- Activate the workflow
The trigger will fire whenever a new inbox item is received or when labels/sentiment are updated.
Example 5: List All Social Profiles
- Add the Agorapulse node to your workflow
- Select Search as the resource
- Select List Profiles as the operation
- Choose your Organization from the dropdown
- Choose your Workspace from the dropdown
- The node will return all social media profiles in that workspace
Resources
Development
Building
npm run build
Linting
npm run lint
npm run lintfix # Auto-fix issues
Formatting
npm run format