iMessage by Photon icon

iMessage by Photon

Send, search, and manage iMessage conversations via the Photon server

Actions22

Message → Send Attachment

AI-generated

Summary

Sends a file from the Photon server Mac's filesystem as an iMessage attachment to a chat, optionally renaming it or sending audio as a voice message.

Inputs

  • Chat GUID (required) — Target chat identifier, e.g. iMessage;-;+1234567890 for a DM or iMessage;+;chat123456 for a group. Get it from List Chats or Create Chat. A bare phone/email or a service;sep;address form is also accepted and normalized.
  • File Path (required) — Absolute path to the file on the machine running the Photon server (not the n8n host). The file must already exist there.
  • Additional Fields > File Name — Overrides the file name shown to the recipient (sent as name).
  • Additional Fields > Send as Voice Message — When true, sends the audio file as an iMessage voice message that plays inline with a waveform.

Output shape

One output item per input item, containing the Photon server's response data for the sent attachment message (the data field of the API response, or the whole response if absent).

Inbound-first policy: before sending, the node queries the last 25 messages in the chat and fails with an error unless the contact has previously messaged you. If the chat doesn't exist, the node tries to create a DM chat from the address in the GUID and retries once. With Continue On Fail enabled, failed items return {error: message}.

Examples

Example 1: Send a generated PDF report to a contact who has messaged you before

Chat GUID = iMessage;-;+15551234567, File Path = /Users/me/reports/weekly.pdf, File Name = Weekly Report.pdf

Example 2: Reply with a voice note

Chat GUID from a trigger/List Chats, File Path = /Users/me/audio/reply.m4a, Send as Voice Message = true

Links

Discussion