integration-apis
Table of Contents
Triggers and Actions available for Make and N8N
The following triggers and actions are offered by the OpenEMM App for Make (https://www.make.com/en/hq/app-invitation/5cffc5c0eba6ddca073a63853c7baeb4) and the OpenEMM Nodes for N8N (Settings → Community nodes → Install @openemm/n8n-nodes-openemm). Several more triggers and actions are already in development.
Triggers
| ID | Functionality | Name of Make module | Name of N8N node | Output |
|---|---|---|---|---|
| TM0 | Webhook has been triggered | Watch events | - | event_type, event_count, events: event_id, event_timestamp, event_data |
| TM1 | mailing dispatch has been completed | Watch completed mailing deliveries | On mailing sent | event_type, event_count, events: event_id, event_timestamp, event_data: mailing_id |
| TR1 | mail has been delivered to recipient | Watch individual mail deliveries | On mail delivered | event_type, event_count, events: event_id, event_timestamp, event_data: mailing_id, recipient_id, recipient_data: profile_field(s) |
| TR6 | test mail has been delivered to recipient | Watch individual test mail deliveries | On test mail delivered | event_type, event_count, events: event_id, event_timestamp, event_data: mailing_id, recipient_id, recipient_data: profile_field(s) |
| TR2 | mail has been bounced | Watch mail bounces | On mail bounced | event_type, event_count, events: event_id, event_timestamp, event_data: mailing_id, recipient_id, recipient_data: profile_field(s) |
| TR3 | mail has beend opened by recipient | Watch mail openings | On mail opened | event_type, event_count, events: event_id, event_timestamp, event_data: mailing_id, recipient_id, recipient_data: profile_field(s) |
| TR4 | link in mail has been clicked by recipient | Watch link clicks | On link clicked | event_type, event_count, events: event_id, event_timestamp, event_data: mailing_id, link_id, recipient_id, recipient_data: profile_field(s) |
| TR5 | mailing has been unsubscribed by recipient | Watch mailing unsubscriptions | On mailing unsubscribed | event_type, event_count, events: event_id, event_timestamp, event_data: mailinglist_id, mediatype, recipient_id, status, opt_out_by, recipient_data: profile_field(s) |
| TR7 | profile field of recipient has been changed | Watch profile field change | On profile field changed | event_type, event_count, events: event_id, event_timestamp, event_data: recipient_id, recipient_data: profile_field(s) |
Actions
Make
| ID | Functionality | Name of Make module | Input | Possible Output |
|---|---|---|---|---|
| AM1 | Send out mailing | Send a mailing | mailing_id | - |
| AM2 | Get data of a mailing | Get a mailing | mailing_id or name | mailing_id, name, description, type |
| AM3 | Create a new mailing list | Create a mailing list | name, description | mailinglist_id, name, description, creation_date, change_date |
| AM4 | Copy an existing mailing | (work in progress) | ||
| AM5 | Update a mailing | (work in progress) | ||
| AM6 | Delete a mailing | (work in progress) | ||
| AM7 | Create a new mailing based on a given template ID | (work in progress) | ||
| AC1 | Update mailing content by ID or name with content IDs and content texts | (work in progress) | ||
| AC2 | Delete mailing content by ID or name | (work in progress) | ||
| AC3 | Read mailing content by ID or name | (work in progress) | ||
| AR1 | Create a new recipient | Create a recipient | any profile field provided by upstream module + mailinglist and status (mapping at configuration time) | customer_id, email, firstname, lastname, gender, title, mailtype, sys_tracking_veto, sys_encrypted_sending, cleaned_date, creation_date, timestamp, lastsend_date, lastopen_date, lastclick_date, datasource_id, latest_datasource_id |
| AR2 | Update an existing recipient | Update a recipient | any profile field provided by upstream module + mailinglist and status (mapping at configuration time) | customer_id, email, firstname, lastname, gender, title, mailtype, sys_tracking_veto, sys_encrypted_sending, cleaned_date, creation_date, timestamp, lastsend_date, lastopen_date, lastclick_date, datasource_id, latest_datasource_id |
| AR3 | Delete an existing recipient | Delete a recipient | - | |
| AR4 | Get data of recipient | Get a recipient | email or customer_id | customer_id, email, firstname, lastname, gender, title, mailtype, sys_tracking_veto, sys_encrypted_sending, cleaned_date, creation_date, timestamp, lastsend_date, lastopen_date, lastclick_date, datasource_id, latest_datasource_id |
| AR5 | Update binding status of recipient on a mailing list | → AR2 | ||
| AR6 | Get binding status of recipient on a mailing list | Get binding status of recipient on mailinglist | email or customer_id, mailing list | mailinglist_id, mediatype, user_status, user_remark, creation_date, change_date |
| - | Generic call of REST API | Make an API call | see REST API documentation | see REST API documentation |
N8N
| ID | Functionality | Name of N8N node | Input | Output |
|---|---|---|---|---|
| AM1 | Send out mailing | Send mailing | mailing_id, send_type (optional), send_date (optional), customer_id (optional), user_status (optional) | JSON provided by RESTful endpoint sendMailingIdPost |
| AM2 | Get data of a mailing | Get mailing | mailing_id or name | JSON provided by RESTful endpoint getMailingByName or by getMailingById with view=“light” to reduce output |
| AM3 | Create a new mailing list | Create mailing list | name, description | JSON provided by RESTful endpoint postMailinglist |
| AM4 | Copy an existing mailing | (work in progress) | JSON provided by RESTful endpoint copyMailingById |
|
| AM5 | Update a mailing | (work in progress) | JSON provided by RESTful endpoint putMailing (possible input fields: shortname, description, mailinglist_id, mailinglist_shortname, mailingtype, mailing_content_type, target_expression, open_action_id, click_action_id) |
|
| AM6 | Delete a mailing | (work in progress) | JSON provided by RESTful endpoint deleteMailing |
|
| AM7 | Create a new mailing based on a given template ID | (work in progress) | JSON provided by RESTful endpoint postMailing |
|
| AC1 | Update mailing content by ID or name with content IDs and content texts | (work in progress) | JSON provided by RESTful endpoint contentMailingIdContentIdPut or contentMailingIdContentNamePut |
|
| AC2 | Delete mailing content by ID or name | (work in progress) | JSON provided by RESTful endpoint contentMailingIdContentIdDelete or componentMailingIdComponentNameDelete |
|
| AC3 | Read mailing content by ID or name | (work in progress) | JSON provided by RESTful endpoint contentMailingIdContentIdGet or contentMailingIdContentNameGet |
|
| AR1 | Create a new recipient | Create recipient | email, profile fields (optional), mailinglist_id (optional), binding_status (optional) | JSON provided by RESTful endpoint recipientPost |
| AR2 | Update an existing recipient | Update recipient | email or customer_id, profile fields (optional), mailinglist_id (optional), binding_status (optional) | JSON provided by RESTful endpoint recipientPut |
| AR3 | Delete an existing recipient | Delete recipient | email/customer_id | JSON provided by RESTful endpoint recipientEmailDelete or recipientCustomerIdDelete |
| AR4 | Get data of recipient | Get recipient | email and arbitrary profile fields with required values (example: gender = 0) | JSON provided by RESTful endpoint getRecipient |
| AR5 | Update binding status of recipient on a mailing list | → AR2 | email, mailinglist_id, status | JSON provided by RESTful endpoint recipientPut |
| AR6 | Get binding status of recipient on a mailing list | Get recipient binding | email or customer_id, mailinglist_id | JSON provided by RESTful endpoint bindingEmailMailinglistIdGet or bindingCustomerIdMailinglistIdGet |
integration-apis.txt · Last modified: 2025/10/14 12:11 by ma
