Actions17
Overview
This node operation allows creating contacts within a specified category in a marketing or contact management system. It supports creating contacts in three categories: Contact Lists, Contact Books, and Contact Tags. Users provide the contact data in JSON format, which the node processes to create the contact accordingly. This is useful for automating contact management tasks such as adding new subscribers, organizing contacts into books, or tagging contacts for segmentation.
Use Case Examples
- Creating a new contact in a contact list with details like first name, last name, email, and subscription status.
- Creating a new contact book by specifying its name in JSON format.
- Creating a new contact tag by providing tag details in JSON format.
Properties
| Name | Meaning |
|---|---|
| Category | Specifies the category of the contact to create, such as Contact Lists, Contact Books, or Contact Tags. |
| Contact JSON Data | The JSON data representing the contact details to create. The structure varies depending on the selected category (list, books, or tags). For example, for Contact Lists, it includes fields like first_name, last_name, email, subscriber, book_id, and tag. |
Output
JSON
id- The unique identifier of the created contact or entity.name- The name of the created contact book or tag (if applicable).email- The email address of the created contact (if applicable).subscriber- Subscription status of the contact (if applicable).book_id- IDs of contact books associated with the contact (if applicable).tag- Tags associated with the contact (if applicable).
Dependencies
- An API key credential for authenticating requests to the Marketing Master IO API.
Troubleshooting
- Ensure the JSON data provided matches the expected structure for the selected category to avoid API errors.
- If the node throws authentication errors, verify that the API key credential is correctly configured and has the necessary permissions.
- Network or API downtime may cause request failures; retry or check API status if errors persist.
Links
- Marketing Master IO API - Contacts - Official API documentation for managing contacts, contact books, and tags.