@messagebird/n8n-nodes-bird 0.4.0 → 0.5.0

package/README.md

@@ -15,14 +15,14 @@ On a self-hosted instance that has not enabled community nodes in the panel, use
 The **Bird** node covers the public Bird API: email and SMS sends, delivery status and event timelines, WhatsApp, verification, templates, sending domains, suppressions, inbound routes, webhooks, statistics, lookup, and more. Resources and operations mirror the API reference at https://bird.com/docs/api. Three areas are deliberately out: publishing and subscribing on Realtime, which needs an app key and secret this credential cannot hold (managing Realtime apps and keys is included); the attachment and media downloads, which return bytes rather than the JSON a workflow item carries; and redirect-based media fetches.
 
 <details>
-<summary><strong>177 operations across 22 resources</strong></summary>
+<summary><strong>178 operations across 22 resources</strong></summary>
 
 - **Audience** (9) — Add Contacts, Create, Delete, Get, List, List Contacts, Remove Contact, Remove Contacts, Update
 - **Contact** (7) — Batch, Create, Delete, Get, List, List Preferences, Update
 - **Contact Property** (6) — Archive, Create, Get, List, Unarchive, Update
 - **Doc** (2) — Read, Search
 - **Domain** (9) — Create, Delete, Get, List, List Events, Release Tracking, Share DNS Records, Update, Verify
-- **Email** (57) — Cancel, Content, Create Inbound Route, Create Mailbox, Create Mailbox Message, Create Mailbox Receive Rule, Delete Inbound Route, Delete Mailbox, Delete Mailbox Receive Rule, Delete Thread, Delete Thread Message, Get, Get Inbound Route, Get Mailbox, Get Mailbox Statistics, Get SMTP Config, Get Thread, Get Thread Message, Get Thread Message Body, List, List Events, List Inbound Routes, List Mailbox Labels, List Mailbox Messages, List Mailbox Receive Rules, List Mailboxes, List SMTP Configs, List Thread Message Attachments, List Thread Messages, List Threads, Recipients, Reply to Thread Message, Restore Mailbox, Resume Mailbox, Send, Send Batch, Stats By Bounce Code, Stats By Broadcast, Stats By Category, Stats By Client, Stats By Complaint Type, Stats By Location, Stats By Mailbox Provider, Stats By Mailbox Provider Region, Stats By Recipient Domain, Stats By Sending Domain, Stats By Sending IP, Stats By Tag, Stats By Template, Stats Daily, Stats Hourly, Stats Summary, Update Inbound Route, Update Mailbox, Update SMTP Config, Update Thread, Update Thread Message
+- **Email** (58) — Cancel, Content, Create Inbound Route, Create Mailbox, Create Mailbox Message, Create Mailbox Receive Rule, Delete Inbound Route, Delete Mailbox, Delete Mailbox Receive Rule, Delete Thread, Delete Thread Message, Get, Get Inbound Route, Get Mailbox, Get Mailbox Statistics, Get SMTP Config, Get Thread, Get Thread Message, Get Thread Message Body, List, List Events, List Inbound Routes, List Mailbox Labels, List Mailbox Messages, List Mailbox Receive Rules, List Mailboxes, List SMTP Configs, List Templates, List Thread Message Attachments, List Thread Messages, List Threads, Recipients, Reply to Thread Message, Restore Mailbox, Resume Mailbox, Send, Send Batch, Stats By Bounce Code, Stats By Broadcast, Stats By Category, Stats By Client, Stats By Complaint Type, Stats By Location, Stats By Mailbox Provider, Stats By Mailbox Provider Region, Stats By Recipient Domain, Stats By Sending Domain, Stats By Sending IP, Stats By Tag, Stats By Template, Stats Daily, Stats Hourly, Stats Summary, Update Inbound Route, Update Mailbox, Update SMTP Config, Update Thread, Update Thread Message
 - **Inbound Address** (5) — Create, Delete, Get, List, Update
 - **Inbound Message** (4) — Attachments, Body, Get, List
 - **Lookup** (2) — Email, Phone Number

package/dist/nodes/Bird/generated/properties.gen.js

@@ -67,6 +67,7 @@ exports.birdProperties = [
             { name: "List Mailbox Receive Rules", value: "mailboxes_receive_rules_list", action: "List receive rules", description: "List receive rules" },
             { name: "List Mailboxes", value: "mailboxes_list", action: "List mailboxes" },
             { name: "List SMTP Configs", value: "smtp_configs_list", action: "List SMTP configs" },
+            { name: "List Templates", value: "templates_list", action: "List email templates", description: "List email templates" },
             { name: "List Thread Message Attachments", value: "threads_messages_attachments", action: "List the attachments of a thread message", description: "List a thread message's attachments" },
             { name: "List Thread Messages", value: "threads_messages_list", action: "List messages in a thread", description: "List messages in a thread" },
             { name: "List Threads", value: "threads_list", action: "List threads" },
@@ -2441,6 +2442,90 @@ exports.birdProperties = [
             },
         ],
     },
+    {
+        displayName: "Return All",
+        name: "returnAll",
+        type: "boolean",
+        displayOptions: { show: { resource: ["email"], operation: ["templates_list"] } },
+        default: false,
+        description: "Whether to return all results or only up to a given limit",
+    },
+    {
+        displayName: "Limit",
+        name: "limit",
+        type: "number",
+        typeOptions: { minValue: 1 },
+        displayOptions: { show: { resource: ["email"], operation: ["templates_list"] } },
+        default: 50,
+        description: "Max number of results to return",
+    },
+    {
+        displayName: "Additional Fields",
+        name: "additionalFields",
+        type: "collection",
+        placeholder: "Add Field",
+        default: {},
+        displayOptions: { show: { resource: ["email"], operation: ["templates_list"] } },
+        options: [
+            {
+                displayName: "Category",
+                name: "category",
+                type: "options",
+                options: [
+                    { name: "Not Set", value: "" },
+                    { name: "Transactional", value: "transactional" },
+                    { name: "Marketing", value: "marketing" },
+                ],
+                default: "",
+                description: "Return only `transactional` or `marketing` templates; omit to return both categories",
+            },
+            {
+                displayName: "Q",
+                name: "q",
+                type: "string",
+                default: "",
+                description: "A case-insensitive substring search across the template's slug, name, and description",
+            },
+            {
+                displayName: "Scope",
+                name: "scope",
+                type: "options",
+                options: [
+                    { name: "Not Set", value: "" },
+                    { name: "System", value: "system" },
+                    { name: "Workspace", value: "workspace" },
+                ],
+                default: "",
+                description: "Filter by who owns the template. Use `system` for our built-in templates and `workspace` for the ones your workspace created. Leave it out to get both.",
+            },
+            {
+                displayName: "Source",
+                name: "source",
+                type: "options",
+                options: [
+                    { name: "Not Set", value: "" },
+                    { name: "Html", value: "html" },
+                ],
+                default: "",
+                description: "Return only templates authored in this format",
+            },
+            {
+                displayName: "Theme",
+                name: "theme",
+                type: "options",
+                options: [
+                    { name: "Arcane", value: "arcane" },
+                    { name: "Barebone", value: "barebone" },
+                    { name: "Matte", value: "matte" },
+                    { name: "Not Set", value: "" },
+                    { name: "Protocol", value: "protocol" },
+                    { name: "Studio", value: "studio" },
+                ],
+                default: "",
+                description: "Filter by the visual theme a built-in template is designed in. Only our built-in templates have a theme, so naming one returns built-ins alone.",
+            },
+        ],
+    },
     {
         displayName: "To",
         name: "to",
@@ -7889,7 +7974,7 @@ exports.birdProperties = [
                     { name: "1y", value: "1y" },
                 ],
                 default: "",
-                description: "How long the mailbox remembers message metadata, extracted text, and attachments. Message bodies and raw MIME stay available for 30 days regardless of tier. Tiers longer than 30 days require a plan that includes them.",
+                description: "How long message metadata, extracted text, and attachments are kept. Original bodies and inbound raw MIME are limited to 30 days on every tier. Longer tiers require a plan that includes them.",
             },
         ],
     },
@@ -8022,7 +8107,7 @@ exports.birdProperties = [
                     { name: "1y", value: "1y" },
                 ],
                 default: "",
-                description: "How long the mailbox remembers message metadata, extracted text, and attachments. Message bodies and raw MIME stay available for 30 days regardless of tier. Tiers longer than 30 days require a plan that includes them. Lowering the tier immediately hides remembered messages older than the new horizon. Deletion waits at least ten minutes and until the background retention update has processed every stored message. The update starts every ten minutes and can take hours for large mailboxes; the next hourly purge deletes eligible messages. A lowering that would affect messages requires `confirm=true`.",
+                description: "How long message metadata, extracted text, and attachments are kept. Original bodies and inbound raw MIME are limited to 30 days on every tier. Longer tiers require a plan that includes them. Lowering the tier requires `confirm=true` when messages would be affected; accepted changes hide those messages immediately. Deletion waits at least ten minutes and until the retention update finishes.",
             },
         ],
     },

package/dist/nodes/Bird/generated/routing.gen.js

@@ -23,6 +23,7 @@ exports.birdRoutes = {
     "email:stats_by_bounce_code": { method: "GET", path: "/v1/email/stats/bounce-codes", pathParams: [], topLevel: [], collections: ["additionalFields", "sort"], query: ["from", "to", "timezone", "category", "sort", "limit"], body: [], jsonFields: [], structured: {}, renames: { "max_results": "limit" }, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: true, idempotencyHeader: false, scopes: ["emails"] },
     "email:stats_by_complaint_type": { method: "GET", path: "/v1/email/stats/complaint-types", pathParams: [], topLevel: [], collections: ["additionalFields", "sort"], query: ["from", "to", "timezone", "category", "sort", "limit"], body: [], jsonFields: [], structured: {}, renames: { "max_results": "limit" }, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: true, idempotencyHeader: false, scopes: ["emails"] },
     "email:stats_by_broadcast": { method: "GET", path: "/v1/email/stats/broadcasts", pathParams: [], topLevel: [], collections: ["additionalFields", "sort"], query: ["from", "to", "category", "sort", "limit"], body: [], jsonFields: [], structured: {}, renames: { "max_results": "limit" }, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: true, idempotencyHeader: false, scopes: ["email_marketing"] },
+    "email:templates_list": { method: "GET", path: "/v1/email/templates", pathParams: [], topLevel: [], collections: ["additionalFields"], query: ["scope", "category", "source", "theme", "q", "limit", "starting_after", "ending_before"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["email_management"] },
     "sms:send": { method: "POST", path: "/v1/sms/messages", pathParams: [], topLevel: ["to"], collections: ["additionalFields"], query: [], body: ["to", "from", "text", "category", "tags", "metadata", "options", "template"], jsonFields: [], structured: { "tags": "list", "metadata": "map", "options": "struct", "template": "struct" }, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["sms"] },
     "sms:send_batch": { method: "POST", path: "/v1/sms/batches", pathParams: [], topLevel: ["messages"], collections: ["additionalFields"], query: [], body: ["messages"], jsonFields: ["messages"], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: true, idempotencyHeader: true, scopes: ["sms"] },
     "sms:get": { method: "GET", path: "/v1/sms/messages/{message_id}", pathParams: ["message_id"], topLevel: ["message_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: false, scopes: ["sms"] },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@messagebird/n8n-nodes-bird",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "The official Bird node for n8n: email, SMS, WhatsApp, and verification, plus a webhook trigger for Bird events.",
   "license": "MIT",
   "author": {