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".
Delete a list
Base url: https://api.sendgrid.com
This endpoint allows you to deletes a specific list.
Optionally, you can also delete contacts associated to the list. The query parameter,
delete_contacts=true, will delete the list and start an asynchronous job to delete associated contacts.
- API Key
Flag indicates that all contacts on the list are also to be deleted.default: False
The delete has been accepted and is processing.
job_id of the async job
The delete has been processed.
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.