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

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.

Compatibility

• Minimum n8n version: 1.0.0
• Tested with: n8n 1.91.3 (Docker)
• Works with n8n Cloud, self-hosted, and Docker deployments

Resources

• n8n Community Nodes Documentation
• Loops API Reference
• Loops Webhooks Documentation

License

MIT