List Signups

Description

The List.php interface is used to add recipients to a contact list that already exists within the platform. This is a two-way interface that allows for recipients to both OPT IN and OUT. **Resource Location** .../interface/list.php **Base URL** [https://response.pure360.com](https://response.pure360.com/) **Custom Version** http://{~customDomain~} **HTTP Method** POST | GET

Data Parameters : OPT Recipient In

WARNING: If you send an email address that has an opted out state via this request - it will opt them back into the profile. If using this for any bulk operations please be aware of this and consider Automated List Upload

key	value	usage
accName	`"TestProfile"`	Profile name to add recipient to
listName	`"Master+List"`	List name to add recipient to
doubleOptin	`"FALSE"`	Passively opt recipient in, and trigger signup confirmation email. Custom confirmation emails can be triggered via signup automations
successUrl	`"http://yourdomain.com/register/success"`	URL to redirect to upon successful completion (OK) : Use NO-REDIRECT for test purposes
errorUrl	`"http://yourdomain.com/register/error"`	URL to redirect to upon error completion : Use NO-REDIRECT for test purposes
email	`"test@test.com"`	Email address of recipient being added to the contact list (optional if mobile provided)
mobile	`447875456578`	Mobile number of recipient being added to the contact list (optional if email provided)
firstName	`"bob"`	Custom field firstName to be populated by the value string for this record

Data Parameters : OPT Recipient Out

key	value	usage
accName	`"TestProfile"`	Profile name to add recipient to
mode	`"OPTOUT"`	Set the list builder mode to OPTOUT
email	`"test@test.com"`	Email address of recipient being added to the contact list (optional if mobile provided)
mobile	`447875456578`	Mobile number of recipient being added to the contact list (optional if email provided)

Response

Type	code	content : string
Success	200	OK
Error	200	Error : Error Message

Example - Curl - OPT Recipient In

curl --data "accName=profile&listName=list&doubleOptin=FALSE&successUrl=NO-REDIRECT&errorUrl=NO-REDIRECT&firstName=Test&email=test@test.com" 'http://response.pure360.com/interface/list.php'

This CURL request adds the address "[test@test.com](mailto:test@test.com)" to the list called “list” in the profile called “profile”, it performs validation of the address, doesn’t trigger a doubleOptin email, and assuming the list has the custom field “firstName” it adds the value “Test” for this record.

Example - Curl - OPT Recipient OUT

curl --data "accName=profile&email=test@test.com&mode=OPTOUT" 'http://response.pure360.com/interface/list.php';

This CURL request opts the recipient given by the email address parameter, out of the profile given by the accName parameter.