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

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.