{ "info": { "_postman_id": "d91780bc-bda7-4abd-9001-074e8057639c", "name": "Twilio SendGrid Marketing Campaigns Lists API", "description": "The Twilio SendGrid Marketing Campaigns Lists API allows you to manage your contacts lists programmatically. Lists are static collections of Marketing Campaigns contacts. You can use this API to interact with the list objects themselves. To add contacts to a list, you must use the [Contacts API](https://docs.sendgrid.com/api-reference/contacts/).\n\nYou can also manage your lists using the Contacts menu in the [Marketing Campaigns application user interface](https://mc.sendgrid.com/contacts). For more information about lists and best practices for building them, see [**Building your Contact Lists**](https://sendgrid.com/docs/ui/managing-contacts/building-your-contact-list/).\n\nContact Support:\n Name: Twilio SendGrid Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "lastUpdatedBy": "35240", "uid": "35240-d91780bc-bda7-4abd-9001-074e8057639c" }, "item": [ { "name": "v3", "item": [ { "name": "marketing", "item": [ { "name": "lists", "item": [ { "name": "{id}", "item": [ { "name": "contacts", "item": [ { "name": "count", "item": [ { "name": "Get List Contact Count", "id": "381dce36-6d7a-4717-a58c-2a10734c4a22", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id/contacts/count", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id", "contacts", "count" ], "variable": [ { "id": "ba39e66c-8dca-4fd7-b6ac-213b7f61db20", "key": "id", "value": "", "description": "(Required) " } ] }, "description": "**This endpoint returns the number of contacts on a specific list.**" }, "response": [ { "id": "c031ef60-6894-4ca6-8599-1607a562f116", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id/contacts/count", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id", "contacts", "count" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"contact_count\": \"\",\n \"billable_count\": \"\"\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-c031ef60-6894-4ca6-8599-1607a562f116" }, { "id": "84be0d97-3295-48fa-abac-f75dedb9ab60", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id/contacts/count", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id", "contacts", "count" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-84be0d97-3295-48fa-abac-f75dedb9ab60" } ], "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-381dce36-6d7a-4717-a58c-2a10734c4a22" } ], "id": "4a868550-cec7-42f7-9787-5cddf3ad1bf0", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-4a868550-cec7-42f7-9787-5cddf3ad1bf0" }, { "name": "Remove Contacts from a List", "id": "45b0e3db-959e-451c-9d9b-5c1d8712cb38", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id/contacts?contact_ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id", "contacts" ], "query": [ { "description": "(Required) Comma separated list of contact IDs that you want to remove from the specified contacts list.", "key": "contact_ids", "value": "" } ], "variable": [ { "id": "15359c3d-f070-40a8-9aee-5ddd328ad729", "key": "id", "value": "", "description": "(Required) The ID of the list on which you want to perform the operation." } ] }, "description": "**This endpoint allows you to remove contacts from a given list.**\n\nThe contacts will not be deleted. Only their list membership will be changed." }, "response": [ { "id": "c52e7a59-7deb-421b-8ca5-8b41402233e6", "name": "response", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id/contacts?contact_ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id", "contacts" ], "query": [ { "description": "(Required) Comma separated list of contact IDs that you want to remove from the specified contacts list.", "key": "contact_ids", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"job_id\": \"\"\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-c52e7a59-7deb-421b-8ca5-8b41402233e6" }, { "id": "739ff3a0-e318-46c2-a021-8d447c53a2d7", "name": "response", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id/contacts?contact_ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id", "contacts" ], "query": [ { "description": "(Required) Comma separated list of contact IDs that you want to remove from the specified contacts list.", "key": "contact_ids", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"message\": \"\",\n \"field\": \"\",\n \"error_id\": \"\",\n \"parameter\": \"\"\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-739ff3a0-e318-46c2-a021-8d447c53a2d7" }, { "id": "73582630-ce6a-4177-8861-840f5c4bf904", "name": "response", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id/contacts?contact_ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id", "contacts" ], "query": [ { "description": "(Required) Comma separated list of contact IDs that you want to remove from the specified contacts list.", "key": "contact_ids", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"description\": \"The specified list ID does not exist or one or more contact IDs do not exist.\"\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-73582630-ce6a-4177-8861-840f5c4bf904" } ], "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-45b0e3db-959e-451c-9d9b-5c1d8712cb38" } ], "id": "e1616eb3-57fb-4144-9e19-9fee045a4dc6", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-e1616eb3-57fb-4144-9e19-9fee045a4dc6" }, { "name": "Get a List by ID", "id": "c499bded-85d8-48cf-8ca3-a83366f90946", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id?contact_sample=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "query": [ { "description": "Setting this parameter to the true will cause the contact_sample to be returned", "key": "contact_sample", "value": "false" } ], "variable": [ { "id": "9256f913-9767-472b-ad57-2de64eb77c0d", "key": "id", "value": "", "description": "(Required) The ID of the list on which you want to perform the operation." } ] }, "description": "**This endpoint returns data about a specific list.**\nSetting the optional parameter `contact_sample=true` returns the `contact_sample` in the response body. Up to 50 of the most recent contacts uploaded or attached to a list will be returned.\nThe full contact count is also returned." }, "response": [ { "id": "8a2640c3-3f18-4d5a-9717-207622bcb4b9", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id?contact_sample=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "query": [ { "description": "Setting this parameter to the true will cause the contact_sample to be returned", "key": "contact_sample", "value": "false" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"contact_count\": \"\",\n \"_metadata\": {\n \"self\": \"\"\n },\n \"contact_sample\": {\n \"id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"unique_name\": \"\",\n \"email\": \"\",\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\",\n \"alternate_emails\": [\n \"\",\n \"\"\n ],\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"city\": \"\",\n \"state_province_region\": \"\",\n \"country\": \"\",\n \"postal_code\": \"\",\n \"phone_number\": \"\",\n \"whatsapp\": \"\",\n \"line\": \"\",\n \"facebook\": \"\",\n \"segment_ids\": [\n \"\",\n \"\"\n ],\n \"custom_fields\": {},\n \"_metadata\": {\n \"self\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-8a2640c3-3f18-4d5a-9717-207622bcb4b9" }, { "id": "170e5305-4b95-4ddb-a9b9-c94df8255992", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id?contact_sample=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "query": [ { "description": "Setting this parameter to the true will cause the contact_sample to be returned", "key": "contact_sample", "value": "false" } ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n {\n \"message\": \"\",\n \"field\": \"\",\n \"error_id\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"error_id\": \"\",\n \"parameter\": \"\"\n }\n]", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-170e5305-4b95-4ddb-a9b9-c94df8255992" } ], "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-c499bded-85d8-48cf-8ca3-a83366f90946" }, { "name": "Update List", "id": "17474594-75aa-4d24-aef7-1354ae417cd2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "variable": [ { "id": "70caa07b-ccdf-4017-9723-b1d5ccff20e6", "key": "id", "value": "", "description": "(Required) The ID of the list on which you want to perform the operation." } ] }, "description": "**This endpoint updates the name of a list.**" }, "response": [ { "id": "baf1f2af-a59f-4a19-b8d8-864dfd4f7b72", "name": "response", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"contact_count\": \"\",\n \"_metadata\": {\n \"self\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-baf1f2af-a59f-4a19-b8d8-864dfd4f7b72" }, { "id": "e2e7202f-ed73-4ac9-a580-d3015248bf27", "name": "response", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"error_id\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"error_id\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-e2e7202f-ed73-4ac9-a580-d3015248bf27" }, { "id": "50e0a4e1-f2b7-443e-aed7-92045c7ef14f", "name": "response", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-50e0a4e1-f2b7-443e-aed7-92045c7ef14f" } ], "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-17474594-75aa-4d24-aef7-1354ae417cd2" }, { "name": "Delete a list", "id": "eb6c77aa-0862-4e25-9cd9-3e9fbc73eba2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id?delete_contacts=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "query": [ { "description": "Flag indicates that all contacts on the list are also to be deleted.", "key": "delete_contacts", "value": "false" } ], "variable": [ { "id": "09f7b2a2-9c02-4206-a118-92f15d4cae30", "key": "id", "value": "", "description": "(Required) The ID of the list on which you want to perform the operation." } ] }, "description": "**This endpoint allows you to deletes a specific list.**\n\nOptionally, 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." }, "response": [ { "id": "7af1216c-31b0-4513-a9bf-8118fcfa6740", "name": "response", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id?delete_contacts=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "query": [ { "description": "Flag indicates that all contacts on the list are also to be deleted.", "key": "delete_contacts", "value": "false" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"job_id\": \"\"\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-7af1216c-31b0-4513-a9bf-8118fcfa6740" }, { "id": "8e38d47c-237e-4130-8aa5-39cd7e221c7e", "name": "response", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id?delete_contacts=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "query": [ { "description": "Flag indicates that all contacts on the list are also to be deleted.", "key": "delete_contacts", "value": "false" } ], "variable": [ { "key": "id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-8e38d47c-237e-4130-8aa5-39cd7e221c7e" }, { "id": "c867a365-68e6-4b81-ae39-892f0bc14eb1", "name": "response", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists/:id?delete_contacts=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists", ":id" ], "query": [ { "description": "Flag indicates that all contacts on the list are also to be deleted.", "key": "delete_contacts", "value": "false" } ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": []\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-c867a365-68e6-4b81-ae39-892f0bc14eb1" } ], "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-eb6c77aa-0862-4e25-9cd9-3e9fbc73eba2" } ], "id": "9c6d3d0e-3815-4fb0-8d4b-f87f9ed9187c", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-9c6d3d0e-3815-4fb0-8d4b-f87f9ed9187c" }, { "name": "Create List", "id": "9eafa27d-f9a3-4eab-9c8a-9e660d15f649", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/lists", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists" ] }, "description": "**This endpoint creates a new contacts list.**\n\nOnce you create a list, you can use the UI to [trigger an automation](https://sendgrid.com/docs/ui/sending-email/getting-started-with-automation/#create-an-automation) every time you add a new contact to the list.\n\nA link to the newly created object is in `_metadata`." }, "response": [ { "id": "4c3c9184-8997-4b3b-b9b4-8d3792810727", "name": "response", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/lists", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"contact_count\": \"\",\n \"_metadata\": {\n \"self\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-4c3c9184-8997-4b3b-b9b4-8d3792810727" }, { "id": "db35698a-4b9c-40a8-bd06-7d67bb38fee0", "name": "response", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/lists", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"error_id\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"error_id\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-db35698a-4b9c-40a8-bd06-7d67bb38fee0" } ], "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-9eafa27d-f9a3-4eab-9c8a-9e660d15f649" }, { "name": "Get All Lists", "id": "fde76a32-3886-4ce5-adb6-c4fce1727ff1", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists?page_size=100&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists" ], "query": [ { "description": "Maximum number of elements to return. Defaults to 100, returns 1000 max", "key": "page_size", "value": "100" }, { "key": "page_token", "value": "" } ] }, "description": "**This endpoint returns an array of all of your contact lists.**" }, "response": [ { "id": "ffb00990-8f25-4676-86b4-ba52207ad432", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/lists?page_size=100&page_token=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "lists" ], "query": [ { "description": "Maximum number of elements to return. Defaults to 100, returns 1000 max", "key": "page_size", "value": "100" }, { "key": "page_token", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"contact_count\": \"\",\n \"_metadata\": {\n \"self\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"contact_count\": \"\",\n \"_metadata\": {\n \"self\": \"\"\n }\n }\n ],\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\",\n \"count\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-ffb00990-8f25-4676-86b4-ba52207ad432" } ], "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-fde76a32-3886-4ce5-adb6-c4fce1727ff1" } ], "id": "321e5bb1-af3e-4c87-9c23-729b80d87328", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-321e5bb1-af3e-4c87-9c23-729b80d87328" } ], "id": "7e597711-102f-4919-b8fd-2bd972b59021", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-7e597711-102f-4919-b8fd-2bd972b59021" } ], "id": "2977290a-2888-4dc1-8151-8b55f77e09ec", "createdAt": "2026-06-05T15:17:31.000Z", "updatedAt": "2026-06-05T15:17:31.000Z", "uid": "35240-2977290a-2888-4dc1-8151-8b55f77e09ec" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.sendgrid.com" } ] }