Marketing Platform Action

Use this action to add, update or delete a contact in a given Marketing Platform list.

Settings

The action uses the following settings:

Setting	Description	Parsed
Mode	The mode that will be used by the action.	⛔
Force Resubscribe	If the email has been added and then deleted previously from the Marketing Platform list, The resubscribe will fail without this flag.	⛔
API Username	The API Username you can retrieve from your Marketing Platform account.	✅
API Token	The API Token you can retrieve from your Marketing Platform account.	✅
List Name	The name of the list where the contact will be added.	✅
Email Address	The email address of the contact that will be added to the list.	✅
Merge Fields	The fields you would like to fill for the contact.	✅

Remarks

You can retrieve your Marketing Platform API Username and API Token from your Marketing platform account details: From the left main menu, click on 'INTEGRATION', then select 'MANAGE API KEY' in the flyout menu. Your API Key information will be listed in the table labeled 'Created API Accesses'.

The List Name must be a valid name from your Marketing Platform defined profiles list. If the list is not found, the action will not be completed.

The action will automatically look in the selected list for an existing contact with the specified email. If the contact is found, merge fields will be updated according to the data you set. If not found, the contact will be added.

Merge fields should be specified in a NAME=VALUE notation, with one field on each line, similarly to the picture below:

As in all other Connect fields, dynamic parsing is fully supported. If a merge field is not found, the action will ignore it and continue with other merge fields.

Trigger

This action has no triggers.

Variables

This action produces the following variables:

Name	Description
marketing_platform_result	This variable contains the execution result of the action
marketingplatform_profileid	This variable contains the Marketing Platform profile id

The possible values of the variable 'marketingplatform_result' are the following:

Value	Description
email_empty	The email field is null or empty
operation_failed	There was a generic error while executing the actioniable contains the Marketing Platform profile id
getlist_failed	There was an error while getting the Marketing Platform list informations
deleteprofile_failed	There was an error while deleting the Marketing Platform profile
resubscribeprofile_needed	The Marketing Platform profile for the specified email is deleted and the 'force resubscribe' flag is not set
addprofile_failed	There was an error while adding the Marketing Platform profile
updateprofile_failed	There was an error while updating the existing Marketing Platform profile
resubscribeprofile_failed	There was an error while resubscribing the Marketing Platform profile to the list

Availability

Channel specific availability follows the table below:

Channel	Availability
Facebook	Fully Available.
WhatsApp	Fully Available.
Telegram	Fully Available.
Web	Fully Available.
Alexa	Fully Available.
Google Assistant	Fully Available.
Slack	Fully Available.
API	Fully Available.