Description
n8n-nodes-loops
This is an n8n community node for Loops — the email platform for modern SaaS. It lets you manage contacts, send events, deliver transactional emails, and receive webhooks directly from your n8n workflows.
n8n is a fair-code licensed workflow automation platform.
Installation · Operations · Credentials · Compatibility · Resources
Installation
Follow the installation guide in the n8n community nodes documentation.
npm package name: n8n-nodes-loops
Self-hosted
1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-loops and confirm
Docker
Mount your custom nodes directory into the container:
volumes:
- ~/.n8n:/home/node/.n8n
Then install the package inside ~/.n8n/nodes/:
cd ~/.n8n/nodes
npm install n8n-nodes-loops
Restart n8n to load the new nodes.
Operations
Loops (Action Node)
| Resource | Operation | Description |
|—|—|—|
| API Key | Test | Validate that the API key is valid |
| Contact | Create | Create a new contact |
| Contact | Delete | Delete a contact by email or user ID |
| Contact | Find | Find a contact by email or user ID |
| Contact | Update | Update an existing contact |
| Contact Property | Create | Create a custom contact property |
| Contact Property | List | List all contact properties |
| Dedicated Sending IP | List | Retrieve dedicated sending IP addresses |
| Event | Send | Send an event with properties and mailing list updates |
| Mailing List | List | List all mailing lists |
| Transactional Email | List | List published transactional email templates |
| Transactional Email | Send | Send a transactional email with variables and attachments |
Loops Trigger (Webhook Node)
Starts workflows when Loops sends webhook events. Supports all 17 event types:
- Contact events: created, deleted, unsubscribed, mailing list subscribed/unsubscribed
- Email send events: campaign sent, loop sent, transactional sent
- Email delivery events: delivered, soft bounced, hard bounced
- Email engagement events: opened, clicked, unsubscribed, resubscribed, spam reported
- Test event: for verifying webhook configuration
- Minimum n8n version: 1.0.0
- Tested with: n8n 1.91.3 (Docker)
- Works with n8n Cloud, self-hosted, and Docker deployments
- n8n Community Nodes Documentation
- Loops API Reference
- Loops Webhooks Documentation
The trigger includes HMAC-SHA256 signature verification with replay attack protection.
Credentials
Loops API
Used by the Loops action node.
1. Log into Loops
2. Go to Settings > API
3. Copy your API key
4. In n8n, create a new Loops API credential and paste the key
Loops Webhook API
Used by the Loops Trigger node.
1. In your Loops dashboard, go to Settings > Webhooks
2. Add your n8n webhook URL (shown in the trigger node’s Webhook URLs section)
3. Enable the events you want to receive
4. Copy the Signing Secret
5. In n8n, create a new Loops Webhook API credential and paste the signing secret
The signing secret is optional but recommended for production use. Without it, signature verification is skipped.
Example Workflows
New signup: create contact and send event
1. Webhook node receives a signup payload
2. Loops node — Contact > Create (email, firstName, lastName)
3. Loops node — Event > Send (eventName: signup, email)
Stripe cancellation: update contact for win-back
1. Stripe Trigger node fires on customer.subscription.deleted
2. Loops node — Contact > Update (email, subscribed: false)
3. Loops triggers a win-back automation based on the contact update
Rate Limits
The Loops API allows 10 requests per second. The node surfaces 429 errors with a clear message. Use n8n’s retry-on-failure setting to handle bursts.
