@inboxapp/n8n-nodes-inboxapp 0.1.2 → 0.2.0

package/README.md

@@ -1,43 +1,41 @@
 # n8n-nodes-inboxapp
 
-[n8n](https://n8n.io/) community node for [InboxApp](https://inboxapp.com) — the Social Selling CRM for X (Twitter).
+[n8n](https://n8n.io/) community node for [InboxApp](https://inboxapp.com), the Social Selling CRM.
 
 Automate your DM outreach, manage conversations, and build sales pipelines directly from n8n workflows.
 
 ![InboxApp + n8n](https://img.shields.io/badge/InboxApp-n8n-blue?style=flat-square) ![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)
 
+This node uses the [InboxApp API v2](https://docs.inboxapp.com/v2/developer-api).
+
 ## Platform Support
 
-| Platform | Status |
-|----------|--------|
-| **X (Twitter)** | ✅ Fully supported |
-| **Instagram** | 🔜 Coming soon |
-| **LinkedIn** | 🔜 Coming soon |
+Every platform uses the same resources. X (Twitter) is available to every team, and a team may have others enabled. **Platforms → Platforms List** returns the platforms your team can use and what each one supports.
 
 ## What You Can Do
 
 ### 💬 Send & Manage DMs
-- **Send direct messages** to any X user through your connected accounts
-- **Reply to conversations** — continue existing DM threads
-- **List conversations** — pull all your DM threads with filtering and pagination
-- **Look up threads** by user ID or username
-- **Delete messages** you've sent
-- **Add reactions** to messages
-
-### 👥 Manage Prospects (Leads)
-- **Look up prospects** by platform ID
-- **Update prospect context** — add notes and custom data to profiles
-- **Access full profile data** — bio, location, follower counts, verification status
+- **Send direct messages** to a thread, a contact, or a platform user through your connected accounts
+- **Send safely** with an idempotency key, so a retried run never sends twice
+- **List conversations** with filters for folder, account, contact, tag, status and assignee
+- **Edit, unsend and react to messages**, and read a message's edit history
+- **Archive, assign and mark threads** as unread
+
+### 👥 Manage Contacts
+- **Find contacts** by platform ID or username
+- **Update contacts**: status, notes, valuation and default assignee
+- **Add and remove tags** on a contact
+- **Expand related resources**, such as a thread's contact and profile, in the same call
 
 ### 🏷️ Organize with Tags & Statuses
-- **Create, update, and delete tags** to label your prospects
-- **Manage deal statuses** — build your own sales pipeline stages
+- **Create, update, and delete tags** to label your contacts
+- **Manage statuses** to build your own sales pipeline stages
 - **Assign colors** to tags and statuses for visual organization
 
 ### 👤 Team & Accounts
 - **View team info** and members
-- **List connected X accounts** linked to your workspace
-- **Track events** across your workspace
+- **List connected accounts** linked to your workspace
+- **Replay events** across your workspace
 
 ## Getting Started
 
@@ -76,69 +74,83 @@ Here are some common workflows to get you started:
 #### Send a DM to a New Lead
 
 ```
-Trigger → InboxApp (Lookup Thread by Username) → InboxApp (Send Message)
+Trigger → InboxApp (Messages Send)
 ```
 
-1. Add an **InboxApp** node → select **Threads → Lookup by Username**
-2. Enter the X username of the person you want to DM
-3. Add another **InboxApp** node → select **Messages → Send Message**
-4. Use the thread ID from the previous step
-5. Write your message and run
+1. Add an **InboxApp** node → select **Messages → Messages Send**
+2. Set **Target** to the person's platform ID: `{ "type": "profile", "accountLinkId": "…", "platform": "twitter", "platformId": "…" }`
+3. Write your message
+4. Under **Additional Fields**, set **Idempotency Key** to a value unique to this lead, so a retried run never sends twice
+
+**Target** also takes an existing thread, `{ "type": "thread", "threadId": "…" }`, or a contact, `{ "type": "contact", "accountLinkId": "…", "contactId": "…" }`.
 
 #### Auto-Reply to New Conversations
 
 ```
-Schedule Trigger → InboxApp (List Threads) → Filter (unread) → InboxApp (Send Message)
+Schedule Trigger → InboxApp (Threads List, Folder: No Reply) → InboxApp (Messages Send)
 ```
 
-#### Sync Prospects to Your CRM
+#### Sync Contacts to Your CRM
 
 ```
-Schedule Trigger → InboxApp (List Threads) → InboxApp (Get Prospect) → HTTP Request (CRM API)
+Schedule Trigger → InboxApp (Threads List, Expand: contact,profile) → HTTP Request (CRM API)
 ```
 
-#### Tag Prospects Based on Keywords
+#### Tag Contacts Based on Keywords
 
 ```
-Schedule Trigger → InboxApp (List Threads) → IF (keyword match) → InboxApp (Update Prospect Context)
+Schedule Trigger → InboxApp (Threads List) → IF (keyword match) → InboxApp (Contacts Add Tag)
 ```
 
 ## Available Operations
 
 | Resource | Operations |
 |----------|-----------|
-| **Threads** | List, Create, Get, Update, Delete, Lookup by ID, Lookup by Username |
-| **Messages** | List, Send, Update, Delete, View Edit History, Add/Remove Reactions |
-| **Prospects** | Get, Lookup, Update Context |
+| **Platforms** | List |
+| **Threads** | List, Get, Update, Delete, Typing |
+| **Messages** | List, Get, Send, Edit, Unsend, History, React, Unreact, Attachment |
+| **Contacts** | List, Get, Update, Add Tag, Remove Tag |
 | **Tags** | List, Create, Get, Update, Delete |
 | **Statuses** | List, Create, Get, Update, Delete |
-| **Account Links** | List |
-| **Members** | List, Get |
-| **Team** | Get Info |
+| **Account Links** | List, Get |
+| **Team** | Get, List Members, Get Member |
 | **Events** | List |
 | **Colors** | List (for tags & statuses) |
 
+List operations return `{ data, nextCursor }`. To read the next page, pass `nextCursor` as **Cursor** under **Additional Fields**, with the same filters.
+
 ## Example: DM Outreach Workflow
 
 A complete outreach workflow might look like:
 
 1. **Trigger** — New row in Google Sheets (your lead list)
-2. **InboxApp: Lookup by Username** — Find or create the DM thread
-3. **InboxApp: Send Message** — Send your personalized outreach DM
-4. **InboxApp: Create Tag** — Tag the prospect as "Outreach - Week 1"
-5. **Wait** — Pause for follow-up timing
-6. **InboxApp: Send Message** — Send follow-up if no reply
+2. **InboxApp: Messages Send** — Send your personalized outreach DM to the lead's platform ID
+3. **InboxApp: Contacts Add Tag** — Tag the contact as "Outreach - Week 1"
+4. **Wait** — Pause for follow-up timing
+5. **InboxApp: Messages Send** — Send a follow-up to the thread if there is no reply
 
 This replaces hours of manual DMing with a fully automated pipeline.
 
+## Upgrading from API v1
+
+Earlier versions of this node called API v1. The same API key works on v2, but operations and fields changed, so existing workflows need their InboxApp nodes set up again:
+
+- **Prospects** are now **Contacts**. Look one up with **Contacts List**, filtered by platform and platform ID or username.
+- **Threads Lookup** and **Lookup by Username** are gone. Use **Contacts List**, then **Threads List** filtered by contact.
+- **Threads Create** and **Quick Send** are gone. **Messages Send** takes a thread, contact or profile target.
+- **Members** moved under **Team**.
+- Thread `done` is now `archived`, and list operations return `{ data, nextCursor }`.
+
+See the [migration guide](https://docs.inboxapp.com/v2/migrating-from-v1) for every change.
+
 ## API Docs
 
-Full API documentation: [docs.inboxapp.com](https://docs.inboxapp.com)
+Full API documentation: [docs.inboxapp.com/v2/developer-api](https://docs.inboxapp.com/v2/developer-api)
 
 ## Links
 
 - 🌐 [InboxApp](https://inboxapp.com)
-- 📖 [API Documentation](https://docs.inboxapp.com)
+- 📖 [API Documentation](https://docs.inboxapp.com/v2/developer-api)
 - 🐛 [Report Issues](https://github.com/inboxhq/n8n-nodes-inboxapp/issues)
 - 💬 [n8n Community](https://community.n8n.io/)
 

package/dist/credentials/InboxAppApi.credentials.js

@@ -6,7 +6,7 @@ class InboxAppApi {
         this.name = 'inboxAppApi';
         this.displayName = 'InboxApp API';
         this.icon = 'file:icons/inboxapp.svg';
-        this.documentationUrl = 'https://docs.inboxapp.com/api-reference/introduction';
+        this.documentationUrl = 'https://docs.inboxapp.com/v2/developer-api';
         this.properties = [
             {
                 displayName: 'API Key',
@@ -27,7 +27,7 @@ class InboxAppApi {
         };
         this.test = {
             request: {
-                baseURL: 'https://inboxapp.com/api/v1',
+                baseURL: 'https://inboxapp.com/api/v2',
                 url: '/team',
                 method: 'GET',
             },

package/dist/credentials/InboxAppApi.credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"InboxAppApi.credentials.js","sourceRoot":"","sources":["../../credentials/InboxAppApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,aAAa,CAAC;QAErB,gBAAW,GAAG,cAAc,CAAC;QAE7B,SAAI,GAAS,yBAAyB,CAAC;QAEvC,qBAAgB,GAAG,sDAAsD,CAAC;QAE1E,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,iCAAiC;iBAChD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,6BAA6B;gBACtC,GAAG,EAAE,OAAO;gBACZ,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AApCD,kCAoCC"}
+{"version":3,"file":"InboxAppApi.credentials.js","sourceRoot":"","sources":["../../credentials/InboxAppApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,aAAa,CAAC;QAErB,gBAAW,GAAG,cAAc,CAAC;QAE7B,SAAI,GAAS,yBAAyB,CAAC;QAEvC,qBAAgB,GAAG,4CAA4C,CAAC;QAEhE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,iCAAiC;iBAChD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,6BAA6B;gBACtC,GAAG,EAAE,OAAO;gBACZ,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AApCD,kCAoCC"}

package/dist/nodes/InboxApp/InboxApp.node.js

@@ -14,7 +14,7 @@ class InboxApp {
             group: ['output'],
             version: 1,
             subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
-            description: 'Manage X/Twitter DM conversations, prospects, threads, and messages with InboxApp',
+            description: 'Manage conversations, contacts, threads, and messages with InboxApp',
             defaults: {
                 name: 'InboxApp',
             },
@@ -32,7 +32,8 @@ class InboxApp {
                     Accept: 'application/json',
                     'Content-Type': 'application/json',
                 },
-                baseURL: 'https://inboxapp.com/api/v1',
+                baseURL: 'https://inboxapp.com/api/v2',
+                arrayFormat: 'repeat',
             },
             properties: properties_json_1.default,
         };

package/dist/nodes/InboxApp/InboxApp.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"InboxApp.node.js","sourceRoot":"","sources":["../../../nodes/InboxApp/InboxApp.node.ts"],"names":[],"mappings":";;;;;;AACA,wEAA2C;AAE3C,MAAa,QAAQ;IAArB;QACC,gBAAW,GAAyB;YACnC,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,mBAAmB;YACzB,KAAK,EAAE,CAAC,QAAQ,CAAC;YACjB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,8DAA8D;YACxE,WAAW,EAAE,mFAAmF;YAChG,QAAQ,EAAE;gBACT,IAAI,EAAE,UAAU;aAChB;YACD,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC3B,WAAW,EAAE;gBACZ;oBACC,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,IAAI;iBACd;aACD;YACD,eAAe,EAAE;gBAChB,OAAO,EAAE;oBACR,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;iBAClC;gBACD,OAAO,EAAE,6BAA6B;aACtC;YACD,UAAU,EAAE,yBAA0C;SACtD,CAAC;IACH,CAAC;CAAA;AA9BD,4BA8BC"}
+{"version":3,"file":"InboxApp.node.js","sourceRoot":"","sources":["../../../nodes/InboxApp/InboxApp.node.ts"],"names":[],"mappings":";;;;;;AACA,wEAA2C;AAE3C,MAAa,QAAQ;IAArB;QACC,gBAAW,GAAyB;YACnC,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,mBAAmB;YACzB,KAAK,EAAE,CAAC,QAAQ,CAAC;YACjB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,8DAA8D;YACxE,WAAW,EAAE,qEAAqE;YAClF,QAAQ,EAAE;gBACT,IAAI,EAAE,UAAU;aAChB;YACD,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC3B,WAAW,EAAE;gBACZ;oBACC,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,IAAI;iBACd;aACD;YACD,eAAe,EAAE;gBAChB,OAAO,EAAE;oBACR,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;iBAClC;gBACD,OAAO,EAAE,6BAA6B;gBACtC,WAAW,EAAE,QAAQ;aACrB;YACD,UAAU,EAAE,yBAA0C;SACtD,CAAC;IACH,CAAC;CAAA;AA/BD,4BA+BC"}

package/dist/nodes/InboxApp/InboxApp.node.json

@@ -3,20 +3,16 @@
     "nodeVersion": "1.0",
     "codexVersion": "1.0",
     "categories": ["Sales", "Communication"],
-    "subcategories": {
-        "Sales": ["CRM"],
-        "Communication": ["Social Media"]
-    },
-    "alias": ["inbox", "twitter", "x", "dm", "prospect", "thread", "message"],
+    "alias": ["inbox", "twitter", "x", "dm", "contact", "thread", "message"],
     "resources": {
         "credentialDocumentation": [
             {
-                "url": "https://docs.inboxapp.com/api-reference/introduction"
+                "url": "https://docs.inboxapp.com/v2/developer-api"
             }
         ],
         "primaryDocumentation": [
             {
-                "url": "https://docs.inboxapp.com/api-reference/introduction"
+                "url": "https://docs.inboxapp.com/v2/developer-api"
             }
         ]
     }