# n8n integration

> Automate Email Fast from n8n, self-hosted or cloud: trigger workflows on delivery events over the event bus, and run send or contact actions with a Bearer API key.

Canonical: https://emailfast.dev/integrations/n8n

Self-hostable workflow automation, triggers included.

## Set it up

1. Create a secret API key in your Email Fast dashboard.
2. Install the Email Fast community node and add the API key as an n8n credential.
3. Add the trigger node (registers an event-bus REST hook) or an action node to your workflow.

## Triggers

Triggers are instant REST hooks over the event-egress bus — a subscription (POST /v1/egress/hooks) that fires the moment a delivery signal lands, not a poll. This is the piece the API-only providers leave out.

| Trigger | Event | Fires when |
| --- | --- | --- |
| Email Sent | `email.sent` | The MTA accepted the message for delivery (not recipient-confirmed). |
| Email Opened | `email.opened` | A human open (privacy-proxy prefetches are filtered out). |
| Link Clicked | `email.clicked` | A tracked link in the message was clicked. |
| Email Bounced | `email.bounced` | The receiving server rejected the message (hard bounce). |
| Spam Complaint | `email.complained` | The recipient marked the message as spam (FBL). |
| Send Failed | `email.failed` | The message could not be sent after exhausting retries. |
| Unsubscribed | `email.unsubscribed` | The recipient unsubscribed (one-click or preference centre). |

## Actions

Every action is a direct call to the REST API, authenticated with your Bearer key.

| Action | Endpoint | What it does |
| --- | --- | --- |
| Send Email | `POST /v1/emails` | Send a one-off email with an inline subject and HTML body. |
| Send Email (by template) | `POST /v1/emails` | Send using a stored template slug; subject, body, cc/bcc and reply-to default from the template. |
| Create or Update Contact | `POST /v1/contacts` | Create a contact or merge attributes into an existing one (used for list/segment membership via attributes). |
| Track Contact Event | `POST /v1/events` | Record a behavior event on a contact — the segment-membership / CDP signal journeys enroll and branch on. |
| Add Suppression | `POST /v1/suppressions` | Suppress an address (globally or on one stream) so it is never delivered to. |
| Remove Suppression | `DELETE /v1/suppressions` | Lift a suppression for an address (a whole stream, or every stream when omitted). |

## Next

- [Read the n8n docs](https://electronicmailfast.com/docs/integrations/n8n)
- [Browse all integrations](/integrations)
- [Get a key and start](/get-started)