Contacts API - Lists
Elements that can be shared among more than one endpoint definition.
Create a List
POST /v3/contactdb/lists
Base url: https://api.sendgrid.com
This endpoint allows you to create a list for your recipients.
Authentication
- API Key
Headers
Request Body
{
"name": "your list name"
}
Responses
The reference ID of your list.
The name of your list. Must be unique against all other list and segment names.
The count of recipients currently in the list.
{
"id": 1,
"name": "listname",
"recipient_count": 0
}
the error message
the field that generated the error
helper text or docs for troubleshooting
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}
the error message
the field that generated the error
helper text or docs for troubleshooting
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.