@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)

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter @agorapulse/n8n-nodes-agorapulse in the npm Package Name field
4. 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:

1. Log in to your Agorapulse account
2. Navigate to Settings > Personal > Open API (https://app.agorapulse.com/(settings:personal/open-api))
3. Generate a new API key
4. Copy the API key

In n8n:

1. Go to Credentials > New
2. Search for Agorapulse API
3. Paste your API key
4. Select the environment (Production recommended)
5. 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

1. Add the Agorapulse node to your workflow
2. Select Action as the resource
3. Select Create Note as the operation
4. Choose your Organization from the dropdown
5. Choose your Workspace from the dropdown
6. Enter a Title for the note
7. Select a Color
8. Set Start Date and End Date
9. Optionally select Profiles to associate with the note
10. Optionally add a Body description

Example 2: Create a Draft Post

1. Add the Agorapulse node to your workflow
2. Select Action as the resource
3. Select Create Draft as the operation
4. Choose your Organization from the dropdown
5. Choose your Workspace from the dropdown
6. Select the post Type (Text, Photo, Video, etc.)
7. Enter the Text content
8. Optionally add Link, Labels, Media URLs
9. Select Profiles where the post will be published
10. Optionally set Publishing Dates to schedule the post

Example 3: Monitor Published Posts

1. Add the Agorapulse Publishing Post Trigger node to your workflow
2. Choose your Organization from the dropdown
3. Connect subsequent nodes to process the webhook data
4. 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

1. Add the Agorapulse Inbox Item Trigger node to your workflow
2. Choose your Organization from the dropdown
3. Connect subsequent nodes to process incoming messages
4. 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

1. Add the Agorapulse node to your workflow
2. Select Search as the resource
3. Select List Profiles as the operation
4. Choose your Organization from the dropdown
5. Choose your Workspace from the dropdown
6. The node will return all social media profiles in that workspace

Resources

• n8n community nodes documentation
• Agorapulse API Documentation
• Agorapulse Help Center

Development

Building

npm run build

Linting

npm run lint
npm run lintfix  # Auto-fix issues

Formatting

npm run format

License

MIT