Finds if a subscriber is in a specified database contact list or not.
JSON Request Example:
{
"username": "JohnDoe",
"usertoken": "abc123abc123abc123abc123",
"requesttype": "Subscribers",
"requestmethod": "FindSubscriber",
"details": {
"email": "{*email_address*}", /* required */
"list": "{*list_id*}", /* required */
"include_membership": "{*include_membership_boolean*}"
}
}"json_request" element
| Field Name | Description |
| username | Username used to login to Pinpointe |
| usertoken | Unique token for this Pinpointe account |
| requesttype | Subscribers |
| requestmethod | FindSubscriber |
Please note: ALL OPTIONAL tags that are not used should be deleted from submitted call. For example, if <include_membership> element not required, the tag pair should be deleted OR a value of"false", "0" or "no" entered in as a value.
"details" element
| Field Name | Description |
| email (Required) | Email address of the contact to be searched for. |
| list (Required) | List id of the database contact list the contact belongs to. |
"include_membership" element
| include_membership | PieSync requirement: Setting this element's value to true, 1 or yes results in the API call adding a list of all tags that a subscriber is in as part of the returned information for that subscriber. |
Successful Response:
"response" element
| Field Name | Description |
| status | Will return SUCCESS if subscriber was successfully found in specified list |
Unsuccessful Response:
"response" element
| Field Name | Description |
| status | Will return FAILED if unsuccessful |
| errormessage | Text explaining why request failed |