zapier-imessage

Official Zapier integration for the Photon iMessage server (advanced-imessage-kit).

Prerequisites

• A running Photon iMessage server with a public URL and API key
• Node.js 18+
• Zapier Platform CLI

Setup

npm install
npm run build
zapier login
zapier push

Authentication

When connecting the app in Zapier, provide:

• Server URL — your Photon server URL (e.g. https://abc.example.com)
• API Key — the API key from your Photon server

Supported Actions

Type	Name	Description
Trigger	New Message Received	Triggers when a new iMessage is received
Action	Send Message	Send an iMessage from your Photon server
Action	Schedule a Message	Schedule an iMessage to be sent at a future time
Action	React to Message	Send a tapback reaction to a message
Search	Find Messages	Search for messages by text content

Development

npm install
npm run build    # compile TypeScript → dist/
npm test         # build + run Vitest
zapier validate
zapier push

Project Structure

src/
├── index.ts                 # App entry point (defineApp)
├── authentication.ts        # Custom auth (Server URL + API Key)
├── triggers/
│   └── newMessage.ts        # New Message Received (polling)
├── creates/
│   ├── sendMessage.ts       # Send Message
│   ├── scheduleMessage.ts   # Schedule a Message
│   └── reactMessage.ts      # React to Message
└── searches/
    └── findMessages.ts      # Find Messages