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

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 Xenioo 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

marketingplatform_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 action

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.

Last updated

Was this helpful?