You are here:
Query: Subscribers in a Publication or Suppression List
Find subscribers who were placed on a publication or suppression List. Or, find only subscribers on the list with a specific status, such as active or unsubscribed. If you have problems retrieving suppression list data, contact Salesforce Customer Support to activate this feature.
Before You Begin
To use this example, you need a working knowledge of SQL. You can copy and paste the code samples, but you must configure them for your setup.
Create a Target Data Extension
In Contact Builder or Email Studio, create a standard data extension with these properties and fields. This data extension is the destination for your query's data output.
| Target Data Extension | PublicationSuppressionList |
| External Key | PublicationSuppressionList |
| Primary Key | Name | Data Type | Required | Length | Default Value |
|---|---|---|---|---|---|
| X | SubscriberKey | Text | X | 254 | |
| EmailAddress | EmailAddress | X | 254 | ||
| ListName | Text | X | 100 | ||
| ListType | Text | 50 | |||
| Status | Text | X | 25 | ||
| DateAdded | Date | X | |||
| AddMethod | Text | X | 25 | ||
| DateUnsubscribed | Date |
Create a Query Activity
In Automation Studio, create an SQL query with these properties.
| Query Name | PublicationSuppressionList |
| External Key | PublicationSuppressionList |
Sample Query
Copy and paste this query.
SELECT l.subscriberkey,
l.emailaddress,
l.listname,
l.listtype,
l.[status],
l.createddate AS DateAdded,
l.addmethod,
l.dateunsubscribed
FROM [_listsubscribers] AS l
WHERE l.listname = MY_LIST_NAMEFinalize the Query Activity
On the last line, replace MY_LIST_NAME with the name of
your publication or suppression list.
Link the query to the target data extension.
| Target Data Extension | PublicationSuppressionList |
| Data Action | Overwrite |
Save your query activity, and then create and activate an automation that uses the activity.
Query Variation: Return Subscribers with a Specific Status
To return results for subscribers with a specific status, such as active, add this line to the
end of the query. You can also replace active with another
status, such as bounced, held, or unsubscribed.
AND l.[status] = active
