Lists
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
GET /v3/marketing/lists
Base url: https://api.sendgrid.com
This endpoint returns an array of all of your contact lists.
Authentication
- API Key
Headers
Query String
Maximum number of elements to return. Defaults to 100, returns 1000 max
default: 100token corresponding to a specific page of results, as provided by metadata
default: NoneResponses
The generated ID for your list.
maxLength: 36minLength: 36The 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: uriThe URL of the current page of results.
format: uriThe URL of the next page of results. If this field isn't present, you're at the end of the list.
format: uriThe 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.