Follow

Add Subscriber to Lifecycle Campaign

The Add to Lifecycle Campaign command allows you to add one or more existing subscribers to the beginning of a Lifecycle Campaign.

Arguments

The Add to Lifecycle Campaign command requires the following arguments: Command, Realm, Password, Lifecycle Campaign Name, and Data.

api_web?r=myrealm&p=mypass&c=addtolifecyclecampaign&lc_campaign_name=mylccampaign&data=email^john.smith@domain.com

The command is ‘addtolifecyclecampaign', the realm is ‘myrealm’ and the password is ‘mypass’.  The existing subscriber with email 'john.smith@domain.com'  will be added to the Lifecycle Campaign named 'mylccampaign'.  If the campaign is active, the subscriber will move through the Lifecycle Campaign flow immediately.  If the campaign is not active, the email will be added to the next batch to run when the campaign is activated again.

The command expects as least one field in the Data argument.  The email address of an existing subscriber is always required to add subscriber to a Lifecycle Campaign. 

The Add to Lifecycle Campaign command supports the following arguments:

 

Name

Req?

Description

Argument

Command

Yes

Defines the command to use.

cmd= addtolifecyclecampaign

c= addtolifecyclecampaign

Realm

Yes

Name of the realm to run the command.  This is required, and the command will fail if the realm and password do not match.

realm=[realm_name]

r=[realm_name]

Password

Yes

Authentication code for API access.  This is required, and the command will fail if the realm and password do not match.

pwd=[password]

p=[password]

Lifecycle Campaign Name

Yes

Identifier of the Lifecycle Campaign to apply the command.

lc_campaign_name=[lc_campaign_name]

Data Yes Subscriber related data.  Email is always required, and first name field is optional.

data=[fields]

d=[fields]

 

Example

Using all commands and arguments (please note the command is wrapped for display purposes only):

api_web?r=myrealm&p=mypass&c=addtolifecyclecampaign&lc_campaign_name=welcome&data=email,first^john.doe@mydomain.com,john

One subscriber will be added to Lifecycle Campaign named 'welcome'.

Successful results return:

SUCCESS: 1 record(s) processed. 1 users added to Lifecycle Campaign welcome

To add multiple subscribers in the same command, separate each data group using the '^':

api_web?r=myrealm&p=mypass&c=addtolifecyclecampaign&lc_campaign_name=welcome&data=email,first^john.doe@mydomain.com,john^jane.doe@mydomain.com,jane^jack.doe@mydomain.com,jack

Successful results return:

SUCCESS: 1 record(s) processed. 1 users added to Lifecycle Campaign welcome

Customer Key Example

Some systems have the ability to define a unique Customer Key per subscriber.  If your realm has Customer Key enabled, then you must include the customer_key in the data argument.  The email data field is optional in this instance. For example:

api_web?r=myrealm&p=mypass&c=addtolifecyclecampaign&lc_campaign_name=welcome&data=customer_key^jd123

or

api_web?r=myrealm&p=mypass&c=addtolifecyclecampaign&lc_campaign_name=welcome&data=customer_key,email^jd123,john.doe@mydomain.com

If the Customer Key is not included, the command will fail.

Results

The Add to Lifecycle Campaign command outputs either a SUCCESS or FAILURE message. 

SUCCESS

The Add to Lifecycle Campaigncommand success message returns the SUCCESS message and includes the number of records processed and the lifecycle campaign name.  The result format is:

SUCCESS: [number sent] record(s) processed. [number added] users added to Lifecycle Campaign [lc_campaign_name]

If the Add to Lifecycle Campaigncommand includes records for more than one subscriber, all matching subscribers will be added.  The result only indicates the total number and does not return errors or reasons why some may have failed.

FAILURE

A Add to Lifecycle Campaign command will fail for several reasons.  The result format is:

FAILURE: [Reason]  

 
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk