iMessage by PhotonInstall

Summary

Creates a new iMessage or SMS conversation (DM or group) on the Photon server with the given participants, optionally sending an initial message, and returns the server's response for the new chat.

Inputs

• Participants (required) — Comma-separated phone numbers or email addresses. The string is split on commas and each entry trimmed. One participant creates a DM; several create a group chat.
• Additional Fields > Initial Message — Text sent immediately when the chat is created. Only included in the request if non-empty.
• Additional Fields > Service — iMessage (default) or SMS. SMS is only available for phone numbers.

Output shape

One output item per input item, containing the data field of the Photon server's response to POST /api/v1/chat/new (or the whole response if there is no data field). It typically includes the new chat's GUID.

The chat is always created via the Private API method. The exact fields come from the server and are not shaped by the node. With Continue On Fail enabled, a failing item returns {error: message}. Unlike send operations, this operation does not apply the node's inbound-first policy check. Use the returned chat GUID in other operations such as Send Message.

Examples

Example 1: Start a DM with a customer and greet them

Participants: +15551234567; Additional Fields: Initial Message = 'Hi! Thanks for signing up.'

Example 2: Create a group chat for a team

Participants: +15551234567, alice@example.com, +15557654321; Service: iMessage

Example 3: Open an SMS thread with a non-iMessage phone

Participants: +15551234567; Service: SMS

Links

• n8n community nodes installation guide