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".
Create List
You can create a maximum of 1000 lists.
POST /v3/marketing/lists
Base url: https://api.sendgrid.com
This endpoint creates a new contacts list.
Once you create a list, you can use the UI to trigger an automation every time you add a new contact to the list.
A link to the newly created object is in _metadata
.
Authentication
- API Key
Headers
Request Body
Your name for your list
maxLength: 100minLength: 1{
"name": "list-name"
}
Responses
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.
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.