List Newsletter Subscribers

Lists every newsletter subscriber in the store — the data behind the admin Marketing → Communications → Newsletter Subscribers datagrid.

TIP

New here? Read the Newsletter Subscribers overview for what a subscriber is and how its fields behave.

Operation

Operation	Type	Purpose
adminMarketingSubscribers	Query	Cursor-paginated list of all newsletter subscribers

Details

• Requires an admin Bearer token in the Authorization header.
• Cursor pagination — pass first for the page size and after (the endCursor from the previous page) to advance. totalCount is the grand total.
• customerId and customerName are null unless the subscriber's email belongs to a registered customer.
• The channel object is detail-only — it resolves on the detail query and is null on list rows.

Filtering

Pass any of these arguments alongside first / after (they mirror the admin datagrid filters):

Argument	Description
email	Email — partial match
channel_id	Channel id — exact match
is_subscribed	0 (unsubscribed) / 1 (subscribed)
sort, order	Sort field (id, email) + asc / desc (default id desc)