n8n-nodes-pumble-integration

n8n-nodes-pumble-integration is a community node that integrates Pumble — a free team messaging and collaboration platform — directly into your n8n workflows.

With this node you can automate your entire Pumble workspace: send and schedule messages to channels, manage threads and direct messages, create and configure channels, and query workspace users and groups — all without leaving n8n.

Typical use cases:

• 🔔 Send real-time notifications to a team channel when a monitored event fires (new form submission, error alert, CI build result)
• 🕐 Schedule recurring digest messages or reminders to be delivered at a precise time
• 💬 Reply inside message threads to keep conversations contextual and organized
• 📢 Create new channels on the fly and add the right users programmatically
• 📩 Send direct messages or group DMs to individuals or custom user groups
• 🔍 Search and retrieve messages to feed downstream workflow steps

---

Table of Contents

• Installation
• Operations
  • Scheduled Message
  • Message
  • Channel
  • Direct Message
  • User
• Credentials
• Sending as a Bot
• Compatibility
• Contributing
• Version History
• License

---

Installation

Follow the installation guide in the n8n community nodes documentation.

1. Go to Settings → Community Nodes
2. Select Install
3. Enter n8n-nodes-pumble-integration and confirm

The node will be available in your workflow editor under the Pumble category.

---

Operations

Scheduled Message

Operation	Description
Create	Schedule a message to be sent to a channel at a specific date and time
Edit	Update the text or delivery time of an existing scheduled message
Get	Retrieve a specific scheduled message by ID
Get Many	List all scheduled messages in a channel
Delete	Delete a scheduled message before it is sent

Message

Operation	Description	Send as Bot
Send	Post a new message to a channel	✅
Edit	Update the text of an existing message	—
Delete	Remove a message from a channel	—
Get	Retrieve a specific message by ID	—
Get Many	List messages in a channel	—
Send Reply	Reply to an existing message inside its thread	✅
Get Thread Replies	Retrieve all replies in a message thread	—
Search	Search for messages in the workspace by keyword	—

Channel

Operation	Description
Create	Create a new channel in the workspace
Get	Retrieve details of a specific channel by ID
Get Many	List all channels in the workspace
Add Users	Add one or more members to an existing channel
Remove User	Remove a member from a channel

Direct Message

Operation	Description
Send	Send a direct message to a single user
Send to Group	Send a message to a group of users via a group DM

User

Operation	Description
Get Many	Retrieve all users in the workspace
Get Me	Retrieve the profile of the authenticated user
Get User Groups	Retrieve all user groups (teams) in the workspace

---

Credentials

To authenticate with Pumble you need an API Key tied to your workspace:

1. Go to your Pumble workspace
2. Navigate to Apps & Integrations → API Keys
3. Generate a new API key
4. Copy your Workspace ID and API Key
5. In n8n, add a new credential of type Pumble API and fill in both fields

📖 Full guide: Pumble API Key Integration

---

Sending as a Bot

The Message → Send and Message → Send Reply operations include a Send As Bot toggle.

When enabled, the message is posted under the workspace's Addon Bot identity (displayed as API with an APP badge in Pumble) instead of the personal account that owns the API Key. This keeps automation messages visually separated from human conversation.

Send As Bot	Message appears as
false (default)	The user who owns the API Key
true	The workspace Addon Bot (API [APP])

How it works under the hood: each API Key in Pumble is linked to a single Addon Bot identity that is created automatically when the key is generated — no manual bot setup is required.

⚠️ Limitations:

• The Addon Bot cannot post to private channels — the API will return a 403 error.
• Bot identity customization (custom name, avatar) is not supported by the Pumble API Addon.
• Direct Messages (dmUser, dmGroup) do not support the asBot parameter.

---

Compatibility

Property	Value
Minimum n8n version	2.11.2
Tested against	n8n 2.11.2 (self-hosted)
Node.js	v22+
Package manager	pnpm
Language	TypeScript

⚠️ Important — sendAt field: The Pumble API expects scheduled message timestamps in milliseconds (e.g. 1714000000000), not Unix seconds and not ISO 8601 strings. This node handles the conversion automatically, applying the timezone offset from the n8n server's configured timezone. No manual conversion is required on your end.

---

Contributing

Contributions, bug reports and feature requests are welcome!

Development setup

Prerequisites: Node.js v22+, pnpm

# 1. Clone the repository
git clone https://github.com/EdordoPng/n8n-nodes-pumble.git
cd n8n-nodes-pumble

# 2. Install dependencies
pnpm install

# 3. Build the node
pnpm build

# 4. (Optional) Watch mode for development
pnpm dev

Submitting a pull request

1. Fork the repository and create a new branch: git checkout -b feat/your-feature
2. Make your changes and ensure the build passes: pnpm build
3. Commit with a clear message following Conventional Commits
4. Push your branch and open a Pull Request against main
5. Describe what the PR changes and why — screenshots or workflow examples are appreciated

---

Version History

v0.1.2 — Send As Bot

Added "Send As Bot" toggle to

→ Send a Message
→ Send a Reply to a Message

When enabled, messages are posted under the workspace Addon Bot identity instead of the authenticated user

v0.1.0 — Initial release

First public release of n8n-nodes-pumble-integration.

Resources implemented:

• Scheduled Message — Create, Edit, Get, Get Many, Delete
• Message — Send, Edit, Delete, Get, Get Many, Send Reply, Get Thread Replies, Search
• Channel — Create, Get, Get Many, Add Users, Remove User
• Direct Message — Send, Send to Group
• User — Get Many, Get Me, Get User Groups

---

Resources

• n8n community nodes documentation
• Pumble API documentation
• Pumble website

---

License

MIT