n8n-nodes-signal-api
v2.0.0
Published
n8n community node for signal-cli-rest-api
Maintainers
Readme
n8n-nodes-signal-api
An n8n community node for interacting with signal-cli-rest-api — a REST API wrapper around signal-cli.
Prerequisites
A running instance of signal-cli-rest-api with at least one registered or linked Signal account.
Installation
In your n8n instance, go to Settings → Community Nodes and install:
n8n-nodes-signal-apiCredentials
Add a Signal CLI REST API credential with:
- Base URL — URL of your signal-cli-rest-api instance (e.g.
http://localhost:8080) - Phone Number — the registered Signal account number in E.164 format (e.g.
+12025551234)
Supported Resources & Operations
Message
| Operation | Description | |---|---| | Send | Send a message to one or more recipients or groups | | Receive | Poll for pending incoming messages | | Send and Wait for Response | Send a message and wait for a reply via WebSocket stream | | Delete (Remote) | Delete a sent message for all recipients | | React | Send a reaction emoji to a message | | Remove Reaction | Remove a previously sent reaction | | Send Receipt | Send a read or viewed receipt |
Group
| Operation | Description | |---|---| | List | List all Signal groups for an account | | Get | Get details of a specific group | | Create | Create a new Signal group | | Update | Update a group's name, description, avatar, or settings | | Delete | Delete a Signal group | | Add Members | Add one or more members to a group | | Remove Members | Remove one or more members from a group | | Add Admins | Promote one or more members to group admin | | Remove Admins | Demote one or more admins to regular members | | Join | Join a group via invite link | | Leave | Leave a Signal group |
Contact
| Operation | Description | |---|---| | List | List all contacts for an account | | Update | Update (or add) a contact entry | | Sync | Send a contacts sync message to all linked devices |
Account
| Operation | Description | |---|---| | List | List all registered and linked accounts |
Attachment
| Operation | Description | |---|---| | List | List all downloaded attachments | | Delete | Remove an attachment from the filesystem |
Usage Notes
- Phone numbers must be in E.164 format (e.g.
+12025551234) - To send to a group, pass the group ID (base64-encoded) as the recipient — it will start with
group. - Attachments can be sent as base64-encoded strings in the formats:
<BASE64>data:<MIME-TYPE>;base64,<BASE64>data:<MIME-TYPE>;filename=<FILENAME>;base64,<BASE64>
- Send and Wait connects to the server's WebSocket stream and resolves the moment a matching reply arrives, so
Max Wait Timeis the only timeout you need to configure.
License
MIT
