Lists are static collections of Marketing Campaigns contacts. This API allows you to interact with the list objects themselves. To add contacts to a list, you must use the Contacts API.
You can also manage your lists using the Contacts menu in the Marketing Campaigns UI. For more information about lists and best practices for building them, see "Building your Contact List".
This endpoint returns an array of all of your contact lists.
Bearer <<YOUR_API_KEY_HERE>>Optional
Maximum number of elements to return. Defaults to 100, returns 1000 max
100Minimum: 1Maximum: 1000Optional
Optional
Optional
1const client = require("@sendgrid/client");2client.setApiKey(process.env.SENDGRID_API_KEY);34const queryParams = { page_size: 100 };56const request = {7url: `/v3/marketing/lists`,8method: "GET",9qs: queryParams,10};1112client13.request(request)14.then(([response, body]) => {15console.log(response.statusCode);16console.log(response.body);17})18.catch((error) => {19console.error(error);20});