post https://{youraccountname}.api-us1.com/api/3/contactLists
Subscribe a contact to a list or unsubscribe a contact from a list.
Resubscribing contacts
If you change a contact's list status from unsubscribed ("2") to active ("1"), you will re-subscribe a contact to a list from which they had manually unsubscribed.
Organization-Related Nodes Have Been Deprecated
Contact-Organization relationships are now managed through Account-Contact end points
{
"contactList": {
"list": 2,
"contact": 1,
"status": 1
}
}
{
"contacts": [
{
"cdate": "2017-07-24T12:09:52-05:00",
"email": "johndoe@example.com",
"phone": "",
"firstName": "John",
"lastName": "Doe",
"orgid": "0",
"segmentio_id": "",
"bounced_hard": "0",
"bounced_soft": "0",
"bounced_date": "0000-00-00",
"ip": "0",
"ua": "",
"hash": "1234567890",
"socialdata_lastcheck": "0000-00-00 00:00:00",
"email_local": "",
"email_domain": "",
"sentcnt": "1",
"rating_tstamp": "0000-00-00",
"gravatar": "0",
"deleted": "0",
"anonymized": "0",
"adate": "2018-10-16T13:52:32-05:00",
"udate": "2018-10-16T13:50:18-05:00",
"deleted_at": "0000-00-00 00:00:00",
"created_utc_timestamp": "2018-10-01 08:40:10",
"updated_utc_timestamp": "2018-10-16 13:50:18",
"links": {
"bounceLogs": "https://:account.api-us1.com/api/:version/contacts/1/bounceLogs",
"contactAutomations": "https://:account.api-us1.com/api/:version/contacts/1/contactAutomations",
"contactData": "https://:account.api-us1.com/api/:version/contacts/1/contactData",
"contactGoals": "https://:account.api-us1.com/api/:version/contacts/1/contactGoals",
"contactLists": "https://:account.api-us1.com/api/:version/contacts/1/contactLists",
"contactLogs": "https://:account.api-us1.com/api/:version/contacts/1/contactLogs",
"contactTags": "https://:account.api-us1.com/api/:version/contacts/1/contactTags",
"contactDeals": "https://:account.api-us1.com/api/:version/contacts/1/contactDeals",
"deals": "https://staging-tjahn.api-us1.com/api/3/contacts/1/deals",
"fieldValues": "https://:account.api-us1.com/api/:version/contacts/1/fieldValues",
"geoIps": "https://:account.api-us1.com/api/:version/contacts/1/geoIps",
"notes": "https://:account.api-us1.com/api/:version/contacts/1/notes",
"organization": "https://:account.api-us1.com/api/:version/contacts/1/organization",
"plusAppend": "https://:account.api-us1.com/api/:version/contacts/1/plusAppend",
"trackingLogs": "https://:account.api-us1.com/api/:version/contacts/1/trackingLogs",
"scoreValues": "https://:account.api-us1.com/api/:version/contacts/1/scoreValues"
},
"id": "1",
"organization": null
}
],
"contactList": {
"contact": "1",
"list": "2",
"form": null,
"seriesid": "0",
"sdate": "2018-10-16T13:52:35-05:00",
"status": 1,
"responder": "1",
"sync": "0",
"unsubreason": "",
"campaign": null,
"message": null,
"first_name": "John",
"last_name": "Doe",
"ip4Sub": "0",
"sourceid": "3",
"autosyncLog": null,
"ip4_last": "0",
"ip4Unsub": "0",
"unsubscribeAutomation": null,
"links": {
"automation": "https://:account.api-us1.com/api/:version/contactLists/2/automation",
"list": "https://:account.api-us1.com/api/:version/contactLists/2/list",
"contact": "https://:account.api-us1.com/api/:version/contactLists/2/contact",
"form": "https://:account.api-us1.com/api/:version/contactLists/2/form",
"autosyncLog": "https://:account.api-us1.com/api/:version/contactLists/2/autosyncLog",
"campaign": "https://:account.api-us1.com/api/:version/contactLists/2/campaign",
"unsubscribeAutomation": "https://:account.api-us1.com/api/:version/contactLists/2/unsubscribeAutomation",
"message": "https://:account.api-us1.com/api/:version/contactLists/2/message"
},
"id": "2",
"automation": null
}
}
Responses