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".
Get All Lists
Base url: https://api.sendgrid.com
This endpoint returns an array of all of your contact lists.
- API Key
Maximum number of elements to return. Defaults to 100, returns 1000 maxdefault: 100
token corresponding to a specific page of results, as provided by metadatadefault: None
The generated ID for your list.maxLength: 36minLength: 36
The name you gave your list.
The number of contacts currently stored on the list.
A link to this object.
The URL of the previous page of results. If this field isn't present, you're at the start of the list.format: uri
The URL of the current page of results.format: uri
The URL of the next page of results. If this field isn't present, you're at the end of the list.format: uri
The number of items in the entire list, i.e., across all pages.
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.