n8n-nodes-aidelly

An official n8n community node for integrating with Aidelly's social media management platform. This package enables n8n users to manage posts, scheduled posts, inbox items, and webhook events within their workflows.

Features

• Post Management: Create and retrieve posts
• Scheduled Posts: Create, list, get, and update scheduled posts
• Inbox Items: Retrieve and list inbox items from connected social accounts
• Webhooks: Receive real-time webhook events for post and inbox updates
• Multiple Platforms: Support for Twitter/X, Instagram, LinkedIn, and more

Installation

From n8n UI

1. Go to your n8n instance
2. Navigate to Community Nodes section
3. Search for n8n-nodes-aidelly
4. Click Install

Manual Installation

npm install n8n-nodes-aidelly

From npm

npm install --save n8n-nodes-aidelly

Setup

1. Create an API Key

First, generate an API key in Aidelly:

1. Log in to Aidelly
2. Go to Settings → API Keys
3. Click Create New Key
4. Copy the API key (starts with whsec_)
5. Copy your Workspace ID

2. Configure Credentials in n8n

1. In n8n, go to Credentials
2. Click New Credential → Search for Aidelly API
3. Fill in:
   • API Key: Your API key from step 1
   • Workspace ID: Your workspace UUID
   • Base URL: https://api.aidelly.com (or your custom instance URL)
4. Click Create

Usage

Create a Post

Add an Aidelly node to your workflow:

1. Set Resource to Post
2. Set Operation to Create
3. Configure:
   • Platform: twitter, instagram, linkedin, etc.
   • Content: The post text
   • Account ID (optional): Specify which account to post from

Schedule a Post

1. Set Resource to Scheduled Post
2. Set Operation to Create
3. Configure:
   • Platform: Social platform
   • Content: Post text
   • Scheduled At: ISO 8601 datetime (e.g., 2025-12-15T14:30:00Z)
   • Timezone: IANA timezone (e.g., America/New_York)

List Scheduled Posts

1. Set Resource to Scheduled Post
2. Set Operation to List
3. Configure pagination with Limit and Offset

Get Inbox Items

1. Set Resource to Inbox Item
2. Set Operation to List or Get
3. For List, you can filter by:
   • Type: Item type (e.g., direct_message, mention)
   • Platform: Comma-separated platform list
   • Include Dismissed: Whether to include dismissed items

Receive Webhooks

Add an Aidelly Trigger node as the start of your workflow:

1. Configure credentials
2. Select Events to listen for:
   • post.created
   • post.scheduled
   • post.published
   • post.failed
   • post.canceled
   • inbox.item.created

The trigger will automatically:

• Create a webhook subscription in Aidelly
• Listen for incoming events
• Clean up the subscription when disabled

API Reference

Authentication

All requests use Bearer token authentication:

Authorization: Bearer <your-api-key>
x-aidelly-workspace-id: <workspace-id>

Available Endpoints

• GET/POST /api/public/v1/posts - Manage posts
• GET/POST/PATCH /api/public/v1/scheduled-posts - Manage scheduled posts
• GET /api/public/v1/inbox/items - List inbox items
• POST/DELETE /api/public/v1/webhooks - Manage webhooks

Rate Limits

Rate limits depend on your Aidelly plan:

Plan	Read	Write
Launch	60/min	20/min
Scale	240/min	90/min
Agency	480/min	180/min

Error Handling

The node includes comprehensive error handling. Common errors:

• PUBLIC_API_RATE_LIMITED - Rate limit exceeded
• PUBLIC_API_SCOPE_FORBIDDEN - API key lacks required scopes
• PUBLIC_API_WORKSPACE_FORBIDDEN - Cannot access requested workspace
• PUBLIC_API_PLAN_INACTIVE - Subscription not active

Examples

Example 1: Post to Twitter on Schedule

Cron Trigger (daily at 9am)
↓
Aidelly (Create Scheduled Post)
  - Platform: twitter
  - Content: "Good morning! {{ env.DAILY_MESSAGE }}"
  - Scheduled At: (next day, 9am)

Example 2: Monitor Inbox for New Messages

Aidelly Trigger (inbox.item.created)
↓
Filter (message_type = direct_message)
↓
Email (send notification)
↓
Aidelly (Get Inbox Item details)

Example 3: Repost on Multiple Platforms

Button Trigger
↓
Set Variables (post content, platforms)
↓
Loop Over Platforms
  ↓
  Aidelly (Create Post)
↓
Notification (post success)

Troubleshooting

"Invalid API Key"

• Verify the key hasn't expired
• Ensure the key starts with whsec_
• Check that the workspace ID is correct

"Workspace Forbidden"

• Confirm you have access to the workspace
• Verify the workspace ID is spelled correctly
• Ensure your API key is not scoped to a different workspace

Webhook Not Triggering

• Check that the event types are correctly selected
• Verify your n8n instance is publicly accessible
• Ensure the webhook URL is reachable from Aidelly's servers
• Check Aidelly's webhook logs for delivery errors

Publishing to n8n Registry

To list this package in the official n8n registry:

1. Ensure your package.json includes the n8n attribute block
2. Submit a PR to n8n-nodes-base or publish to npm
3. Follow the n8n community node guidelines

Support

For issues or questions:

• GitHub: Aidelly/aidelly
• Documentation: docs.aidelly.com
• Email: support@aidelly.com

License

MIT - See LICENSE file for details

Contributing

Contributions are welcome! Please fork the repo and submit PRs to the main Aidelly repository.

Changelog

1.0.0 (2025-01-XX)

• Initial release
• Support for Posts, Scheduled Posts, and Inbox Items
• Webhook trigger for real-time events
• Full Aidelly API v1 integration