Bird
Bird

A world of possibilities.
One place to start.

BIRD / N8N

Send messages
from your workflows

Connect Bird to the workflows you run in n8n. React to a delivery event, protect the recipient and inspect the result before the next customer message.

Explore the connection
BIRD / N8NIllustrative setup · no live connection
n8n / connection
YOUR CONNECTION SETTINGS
Node
Bird Trigger → Bird
Credential
Bird API · API key stored in n8n
Host
Derived from the key’s region prefix
Credential test
Workspace read · not tested here

Use the verified Bird node maintained by Bird. An instance owner or admin installs it when instance settings permit; an installed node still needs a scoped Bird API credential.

Fieldnotes / agent workspace
ILLUSTRATIVE PROJECT

A clear starting point.

  1. Install the verified node

    Use the plus control to find Bird. Members can use a node after an owner or admin installs it.

  2. Authenticate in n8n

    The Bird API credential owns the key. Its workspace read test does not establish permission for every operation.

  3. Prepare this workflow

    Event subscriptions need webhooks permission; reading suppressions needs email_management:read. Check the current node fields and scopes.

Connection not tested by this preview
FROM A REQUEST TO AN OBSERVED RESULT

Ask for a task.
Inspect what happened.

Illustrative workflow. Inspect the result, then follow the setup below to run your own task.

01Hard bounce → policy recorded
REQUESTED TASK

Keep the reason with the record.

A signed bounce arrives for reader@example.com. Inspect its classification and existing suppression records, then save the observed reason and category policy in your application.

EXAMPLE RESULT

Event: email.bounced · fictional signed delivery

Classification: hard bounce

Suppression read: existing automatic record

reason: hard_bounce · applies_to: all

Application finding: saved with source references

Manual suppression: not added

Illustrative task completed: the workflow reads Bird’s existing automatic suppression and saves its policy in the application. Bird already handles hard-bounce suppression. Preserve the original reason and message/recipient references; a manual addition would be a separate all-category restriction.

Read the maintained suppression policy
02Soft bounce → no manual restriction
REQUESTED TASK

This message bounced. The address is not suppressed.

Inspect the original recipient’s terminal soft-class bounced outcome and the current suppression list without adding a manual restriction or sending a new message.

EXAMPLE RESULT

Event: email.bounced · bounce_type: soft

Suppression read: no matching record

Manual restriction: none

Application finding: soft-class bounce

Original recipient outcome: bounced · terminal

This email.bounced event establishes a terminal bounced outcome for the original recipient. The soft classification does not automatically suppress the address. By contrast, email.deferred is temporary and delivery remains pending. Record the bounced result without adding a manual all-category block or creating a fresh send.

Review bounce classification
03Event replay → downstream still uncertain
REQUESTED TASK

A duplicate is not another job.

Inspect a repeated signed event and reconcile the original application finding without repeating its business effect.

EXAMPLE RESULT

Signed event ID: evt_example_bounce

Recent duplicate: recognized by trigger

Trigger’s remembered IDs: bounded to 500

Earlier application finding: unknown

Downstream action: not repeated

The trigger acknowledges a recognized recent duplicate. Its bounded list is not durable business-operation deduplication or exactly-once processing. Reconcile the original application finding in your durable record before deciding recovery.

Review the supported workflow setup
MAKE THE RESULT CLEAR

Connect the tools. Keep the context.

Event verification and retry

Bird Trigger owns endpoint registration and Standard Webhooks verification. Test and production webhook URLs get separate endpoints; quotas apply. Its bounded 500-ID cache does not prove downstream completion. Keep durable business-operation deduplication and reconcile failed or uncertain work at your application owner.

Channel and operation readiness

This example uses webhooks and email_management:read. Bird automatically suppresses hard bounces; soft bounces stay sendable. Complaint records apply to non-transactional mail, while manual additions block all categories. Preserve those reasons and policies. A welcome-email workflow also needs email send permission, a ready sending domain and an eligible recipient. Onboarding sandbox simulation is not delivery to a real inbox. Accepted work is not delivered work.

Supported limits

Realtime publishing/subscriptions, byte downloads, redirect media fetches and reusable email-template authoring have separate paths. A stored SMS template owns its sender and copy: do not combine it with conflicting text, from or category fields.

Ein Node, ein Schlüssel, sonst nichts

n8n nimmt einen API-Schlüssel statt OAuth, und das ist bewusst so: Eine selbst hostbare Plattform bedeutet, dass jede Instanz eine eigene Redirect-URI bräuchte – ein Schlüssel ist also das Credential, das auf n8n Cloud und auf Ihrem eigenen Server gleich funktioniert.

n8n editor
  1. Neuer Workflow
  2. Nodes-Panel
  3. Nach "Bird" suchen
  4. Installieren
Nodes-Panel öffnen
+ oder Tab
Selbst gehostet
Settings › Community Nodes › Install
Paket
@messagebird/n8n-nodes-bird

Installieren Sie den Node auf n8n Cloud oder einer selbst gehosteten Instanz mit aktivierten verifizierten Community-Nodes. Danach steht er in Ihren Workflows zur Verfügung.

Was der Node abdeckt.

Senden Sie Nachrichten, verwalten Sie Kontakte und prüfen Sie die Zustellung mit Operationen, die aus der öffentlichen API generiert werden.

Messaging, Einrichtung und Reporting. Versand, Zustellstatus, Event-Timelines, Templates, Domains, Unterdrückungen, Statistiken und Lookup. Echtzeit-Publishing und -Subscriptions, Byte-Downloads und umleitungsbasierte Medienabrufe sind ausgenommen.

$ Email

$ SMS

Ein Trigger, der sich selbst verifiziert. Subscribe to events and the node registers the webhook, checks each delivery's signature, and suppresses recent duplicate event IDs. Keep durable deduplication for the business action in your application.

$ Bird Trigger

Ein Schlüssel, kein Host. Das Präfix des Schlüssels enthält die Region, sodass dasselbe Credential auf n8n Cloud und selbst gehosteten Instanzen funktioniert – ohne weitere Konfiguration.

$ Bird API credential

Workflows, die sich lohnen

Before your first task

Does a preview prove the workflow is ready?
No. Prepare the actual connection and required product access, inspect the configured workflow and authorize a controlled test. An editor sample or fictional result is not evidence that a production event was received or a business action completed.
What if a send result is unknown?
Keep the original operation and message identifier. Reconcile status before retrying and follow the product’s idempotency contract. A timeout or accepted response does not establish delivery.
How do I choose the right connection?
Use hosted MCP for a compatible remote client, or the local CLI and stdio path for work in your shell. Workflow integrations have their own credentials and supported operations. Follow the maintained setup guide for the client you use.
FROM AGENT TASK TO CUSTOMER MOMENT

A receipt worth
following through.

Prepare a verified sending domain and an eligible recipient. Authorize a test send in your own workflow, retain its message ID, then inspect the recipient’s outcome. Accepted is not delivered; delivered is not read.

For a conversational inbox, choose Agent Mailboxes. For a one-time passcode, follow Verification API setup and distinguish a sent code from a successful check.

f.
FieldnotesTo: Alex Lee

Your order is confirmed.

FIELDNOTESORDER FN–1042

Good things,
on their way.

Thanks, Alex. Your order is confirmed.

Handmade cup
Everyday cupClay / natural glaze
× 1
View your order

Illustrative order FN–1042 contains one Everyday cup. This preview does not open a customer account or change an order.

A transactional email · illustrative order
Fictional receipt preview · no message is sent.
START / BUILD / DIAGNOSE

Keep the next step within reach.

Explore Bird for AI
YOUR NEXT CONNECTION STARTS HERE

From a good prompt.
To a useful connection.

Create a Bird account, follow your client’s setup guide and prepare your first supported product task. Talk to our team about products, permissions and deployment needs.

Starten Sie mit einem Kanal.
Fügen Sie die anderen hinzu, wenn Sie bereit sind.

Ein Test-API-Key steht Ihnen sofort zur Verfügung. Der Produktivzugang wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.

Dokumentation lesen
Sie nutzen Claude Code, Cursor oder Codex? Kopieren Sie einen Setup-Prompt und Ihr Agent installiert die Bird CLI und Skills für Sie. Wählen Sie Ihren:
Cursor