n8n-nodes-imessage
v0.3.5
Published
n8n community node for Photon iMessage — send, receive, and automate iMessage conversations via the Photon server
Maintainers
Readme
n8n-nodes-imessage
This is an n8n community node for Photon iMessage. It lets you send, receive, search, and automate iMessage conversations directly from your n8n workflows.
n8n is a fair-code licensed workflow automation platform.
Prerequisites
Photon hosts the iMessage server for you — no self-hosting required.
- Visit photon.codes to create an account
- Get your Server URL and API Key from the Photon dashboard
Installation
Follow the n8n community nodes installation guide to install n8n-nodes-imessage in your n8n instance.
npm install n8n-nodes-imessageCredentials
- In n8n, go to Credentials and create a new Photon iMessage API credential
- Enter your Server URL — from your Photon dashboard (no trailing slash)
- Enter your API Key — from your Photon dashboard, sent as an
X-API-Keyheader on every request - Click Test to verify the connection
Nodes
Photon iMessage (Action Node)
Perform operations on your iMessage account.
Message
| Operation | Description | |-----------|-------------| | Send Message | Send a text message to a chat. Supports reply-to, message effects (confetti, fireworks, etc.), and subject lines. | | Send Attachment | Send a file from the server Mac to a chat. Supports voice messages. | | Unsend Message | Retract a sent message. | | Edit Message | Edit the text of a sent message. | | React to Message | Send a tapback reaction (love, like, dislike, laugh, emphasize, question). | | Download Attachment | Download a received file or media attachment. | | Search Messages | Search messages by text content across all chats or a specific chat. | | Get Messages | Retrieve messages from a chat with date range and sort options. |
Chat
| Operation | Description | |-----------|-------------| | List Chats | List all conversations with optional last message preview. | | Create Chat | Start a new conversation with one or more participants. | | Mark Chat Read | Mark all messages in a chat as read. | | Start Typing | Show the typing indicator in a chat. | | Stop Typing | Hide the typing indicator in a chat. |
Contact
| Operation | Description | |-----------|-------------| | Share Contact Card | Share your Name and Photo contact card in a chat. |
Poll
| Operation | Description | |-----------|-------------| | Create Poll | Create an interactive poll in a chat. | | Vote | Vote on a poll option. | | Unvote | Remove your vote from a poll option. | | Add Option | Add a new option to an existing poll. |
Scheduled Message
| Operation | Description | |-----------|-------------| | Create Scheduled Message | Schedule a message to send later. Supports one-time and recurring schedules (hourly, daily, weekly, monthly, yearly). | | List Scheduled Messages | View all pending scheduled messages. | | Delete Scheduled Message | Remove a scheduled message. |
Handle
| Operation | Description | |-----------|-------------| | Check iMessage Availability | Check if a phone number or email address supports iMessage. |
Photon iMessage Trigger (Polling Trigger)
Triggers your workflow when new iMessages are received.
| Parameter | Description | |-----------|-------------| | Chat GUID | Only trigger for messages in a specific chat (leave blank for all). | | Include Sent Messages | Also trigger for messages you sent (default: off). | | Max Messages Per Poll | Maximum number of messages to fetch per poll interval (default: 100). |
The trigger polls for new messages and tracks the last message timestamp to avoid duplicates.
Chat GUID Format
The Chat GUID identifies a conversation:
- iMessage DM:
iMessage;-;+1234567890oriMessage;-;[email protected] - SMS DM:
SMS;-;+1234567890 - Group chat:
iMessage;+;chat123456789
Resources
- Photon — Get your API key and server URL
- Photon advanced-imessage-kit — The iMessage SDK
- n8n Community Nodes Documentation
