{ "info": { "_postman_id": "9dc8747f-dcdf-4d72-88bd-e8fb22ce5dee", "name": "Twilio SendGrid Marketing Campaigns Segments API", "description": "This API was deprecated on December 31, 2022. Following deprecation, all segments created in the Marketing Campaigns user interface began using the [Segmentation v2 API](https://docs.sendgrid.com/api-reference/segmenting-contacts-v2).\n\nTo enable manual migration and data retrieval, this API's GET and DELETE operations will remain available. The POST (create) and PATCH (update) endpoints were removed on January 31, 2023 because it is no longer possible to create new v1 segments or modify existing ones. See our [Segmentation v1 to v2 upgrade instructions](https://docs.sendgrid.com/for-developers/sending-email/getting-started-the-marketing-campaigns-v2-segmentation-api#upgrade-a-v1-segment-to-v2) to manually migrate your segments to the v2 API.\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:33.000Z", "updatedAt": "2026-06-05T15:17:33.000Z", "lastUpdatedBy": "35240", "uid": "35240-9dc8747f-dcdf-4d72-88bd-e8fb22ce5dee" }, "item": [ { "name": "v3", "item": [ { "name": "marketing", "item": [ { "name": "segments", "item": [ { "name": "{segment_id}", "item": [ { "name": "Get Segment by ID", "id": "fb082ab3-533f-4006-ad3a-6884f9fbe24f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/segments/:segment_id?query_json=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "query": [ { "description": "Defaults to `false`. Set to `true` to return the parsed SQL AST as a JSON object in the field `query_json`", "key": "query_json", "value": "" } ], "variable": [ { "id": "3f6cbbd3-9ca6-4cb9-9412-854c04153261", "key": "segment_id", "value": "", "description": "(Required) " } ] }, "description": "**This endpoint allows you to retrieve a single segment by ID.**" }, "response": [ { "id": "d9ac2aec-3313-41d2-8459-2f7f4e3619df", "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/segments/:segment_id?query_json=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "query": [ { "description": "Defaults to `false`. Set to `true` to return the parsed SQL AST as a JSON object in the field `query_json`", "key": "query_json", "value": "" } ], "variable": [ { "key": "segment_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"contacts_count\": \"\",\n \"contacts_sample\": [\n {\n \"id\": \"Ca3EACdf-AA49-6567-f64c-5F6a49F4AEbd\",\n \"alternate_emails\": [\n \"\",\n \"\"\n ],\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"city\": \"\u01f1\u022f.\u00bcn\u01f0\",\n \"state_province_region\": \"\",\n \"postal_code\": \"\",\n \"country\": \"\",\n \"custom_fields\": {\n \"custom_field_name1\": \"\",\n \"custom_field_name2\": \"\"\n },\n \"email\": \"\",\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_ids\": [\n \"\",\n \"\"\n ]\n },\n {\n \"id\": \"Df2BBbf7-e49F-8eBB-dA3C-7C18D9B7b19b\",\n \"alternate_emails\": [\n \"\",\n \"\"\n ],\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"city\": \"\u0186\u017e\u017d\u0084`\u00cb\u011b\u016d\u010c\u01a7\",\n \"state_province_region\": \"\",\n \"postal_code\": \"\",\n \"country\": \"\",\n \"custom_fields\": {\n \"custom_field_name1\": \"\",\n \"custom_field_name2\": \"\"\n },\n \"email\": \"\",\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_ids\": [\n \"\",\n \"\"\n ]\n }\n ],\n \"created_at\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"query_dsl\": \"\",\n \"sample_updated_at\": \"\",\n \"updated_at\": \"\",\n \"parent_list_id\": \"\",\n \"next_sample_update\": \"\",\n \"query_json\": {},\n \"parent_list_ids\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-d9ac2aec-3313-41d2-8459-2f7f4e3619df" }, { "id": "2f0f9ed3-ad93-44e7-bb16-119dd165cf81", "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/segments/:segment_id?query_json=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "query": [ { "description": "Defaults to `false`. Set to `true` to return the parsed SQL AST as a JSON object in the field `query_json`", "key": "query_json", "value": "" } ], "variable": [ { "key": "segment_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-2f0f9ed3-ad93-44e7-bb16-119dd165cf81" }, { "id": "7efc2c47-01ec-4316-af7a-4b49d70abc85", "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/segments/:segment_id?query_json=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "query": [ { "description": "Defaults to `false`. Set to `true` to return the parsed SQL AST as a JSON object in the field `query_json`", "key": "query_json", "value": "" } ], "variable": [ { "key": "segment_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-7efc2c47-01ec-4316-af7a-4b49d70abc85" }, { "id": "eb31b70f-e60f-4319-b93a-010b10d29487", "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/segments/:segment_id?query_json=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "query": [ { "description": "Defaults to `false`. Set to `true` to return the parsed SQL AST as a JSON object in the field `query_json`", "key": "query_json", "value": "" } ], "variable": [ { "key": "segment_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\"\n },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-eb31b70f-e60f-4319-b93a-010b10d29487" }, { "id": "db8a0895-d5f0-4cf1-981b-eb485dfa4868", "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/segments/:segment_id?query_json=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "query": [ { "description": "Defaults to `false`. Set to `true` to return the parsed SQL AST as a JSON object in the field `query_json`", "key": "query_json", "value": "" } ], "variable": [ { "key": "segment_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\"\n },\n {\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-db8a0895-d5f0-4cf1-981b-eb485dfa4868" } ], "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-fb082ab3-533f-4006-ad3a-6884f9fbe24f" }, { "name": "Delete Segment", "id": "bf34856c-7d5b-4099-9a21-dd13c7b03e55", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/segments/:segment_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "variable": [ { "id": "d92befc9-6a5d-4445-96cc-76f6e0ee307a", "key": "segment_id", "value": "", "description": "(Required) " } ] }, "description": "**This endpoint allows you to delete a segment by `segment_id`.**\n\nNote that deleting a segment does not delete the contacts associated with the segment by default. Contacts associated with a deleted segment will remain in your list of all contacts and any other segments they belong to." }, "response": [ { "id": "e44e9504-0421-4860-99f5-28b097cc93cb", "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/segments/:segment_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "variable": [ { "key": "segment_id" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-e44e9504-0421-4860-99f5-28b097cc93cb" }, { "id": "06570942-8719-4cc8-b7f7-42beac69e549", "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/segments/:segment_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "variable": [ { "key": "segment_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 \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-06570942-8719-4cc8-b7f7-42beac69e549" }, { "id": "02ed2dde-e47f-4dea-b015-b20205bfb8db", "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/segments/:segment_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "variable": [ { "key": "segment_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-02ed2dde-e47f-4dea-b015-b20205bfb8db" }, { "id": "55e32315-42aa-4bda-b391-f0a9e9645d25", "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/segments/:segment_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "variable": [ { "key": "segment_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-55e32315-42aa-4bda-b391-f0a9e9645d25" }, { "id": "7100e41e-5eb2-4852-b602-99c3421d4582", "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/segments/:segment_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "variable": [ { "key": "segment_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\"\n },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-7100e41e-5eb2-4852-b602-99c3421d4582" }, { "id": "c86dc1f0-28a5-45c0-988d-924803978434", "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/segments/:segment_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments", ":segment_id" ], "variable": [ { "key": "segment_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\"\n },\n {\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-c86dc1f0-28a5-45c0-988d-924803978434" } ], "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-bf34856c-7d5b-4099-9a21-dd13c7b03e55" } ], "id": "42ab0688-307a-4b2f-8b98-0394041eaf50", "createdAt": "2026-06-05T15:17:33.000Z", "updatedAt": "2026-06-05T15:17:33.000Z", "uid": "35240-42ab0688-307a-4b2f-8b98-0394041eaf50" }, { "name": "Get List of Segments", "id": "3e6930e9-f583-4c1b-aa29-c927fdfefd76", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/segments?ids=&ids=&parent_list_ids=&no_parent_list_id=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments" ], "query": [ { "description": "A list of segment IDs to retrieve. When this parameter is included, the `no_parent_list_ids` and `parent_list_ids` parameters are ignored and only segments with given IDs are returned.", "key": "ids", "value": "" }, { "description": "A list of segment IDs to retrieve. When this parameter is included, the `no_parent_list_ids` and `parent_list_ids` parameters are ignored and only segments with given IDs are returned.", "key": "ids", "value": "" }, { "description": "A comma separated list of list ids to be used when searching for segments with the specified parent_list_id, no more than 50 is allowed", "key": "parent_list_ids", "value": "" }, { "description": "If set to `true` segments with an empty value of `parent_list_id` will be returned in the filter. If the value is not present it defaults to 'false'.", "key": "no_parent_list_id", "value": "false" } ] }, "description": "**This endpoint allows you to retrieve a list of segments.**\n\nThe query param `parent_list_ids` is treated as a filter. Any match will be returned. Zero matches will return a response code of 200 with an empty `results` array.\n\n`parent_list_ids` | `no_parent_list_id` | `ids` | `result`\n-----------------:|:--------------------:|:-------------:|:-------------:\nempty | false | empty | all segments values\nlist_ids | false | empty | segments filtered by list_ids values\nlist_ids |true | empty | segments filtered by list_ids and segments with no parent list_ids empty\nempty | true | empty | segments with no parent list_ids\nanything | anything | ids | segments with matching segment ids |" }, "response": [ { "id": "52ba999e-4150-404d-984a-afe90071ebdc", "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/segments?ids=&parent_list_ids=&no_parent_list_id=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments" ], "query": [ { "description": "A list of segment IDs to retrieve. When this parameter is included, the `no_parent_list_ids` and `parent_list_ids` parameters are ignored and only segments with given IDs are returned.", "key": "ids", "value": "" }, { "description": "A comma separated list of list ids to be used when searching for segments with the specified parent_list_id, no more than 50 is allowed", "key": "parent_list_ids", "value": "" }, { "description": "If set to `true` segments with an empty value of `parent_list_id` will be returned in the filter. If the value is not present it defaults to 'false'.", "key": "no_parent_list_id", "value": "false" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"results\": [\n {\n \"id\": \"\",\n \"contacts_count\": \"\",\n \"created_at\": \"\",\n \"sample_updated_at\": \"\",\n \"updated_at\": \"\",\n \"name\": \"\",\n \"parent_list_id\": \"\",\n \"next_sample_update\": \"\"\n },\n {\n \"id\": \"\",\n \"contacts_count\": \"\",\n \"created_at\": \"\",\n \"sample_updated_at\": \"\",\n \"updated_at\": \"\",\n \"name\": \"\",\n \"parent_list_id\": \"\",\n \"next_sample_update\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-52ba999e-4150-404d-984a-afe90071ebdc" }, { "id": "60172582-d0c1-43f8-afd6-0d03cec40d13", "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/segments?ids=&parent_list_ids=&no_parent_list_id=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments" ], "query": [ { "description": "A list of segment IDs to retrieve. When this parameter is included, the `no_parent_list_ids` and `parent_list_ids` parameters are ignored and only segments with given IDs are returned.", "key": "ids", "value": "" }, { "description": "A comma separated list of list ids to be used when searching for segments with the specified parent_list_id, no more than 50 is allowed", "key": "parent_list_ids", "value": "" }, { "description": "If set to `true` segments with an empty value of `parent_list_id` will be returned in the filter. If the value is not present it defaults to 'false'.", "key": "no_parent_list_id", "value": "false" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-60172582-d0c1-43f8-afd6-0d03cec40d13" }, { "id": "4d26d8b2-55db-47b0-9be6-960790067d62", "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/segments?ids=&parent_list_ids=&no_parent_list_id=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments" ], "query": [ { "description": "A list of segment IDs to retrieve. When this parameter is included, the `no_parent_list_ids` and `parent_list_ids` parameters are ignored and only segments with given IDs are returned.", "key": "ids", "value": "" }, { "description": "A comma separated list of list ids to be used when searching for segments with the specified parent_list_id, no more than 50 is allowed", "key": "parent_list_ids", "value": "" }, { "description": "If set to `true` segments with an empty value of `parent_list_id` will be returned in the filter. If the value is not present it defaults to 'false'.", "key": "no_parent_list_id", "value": "false" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-4d26d8b2-55db-47b0-9be6-960790067d62" }, { "id": "bcd0ba81-97d4-48dd-8001-c2356bddbe5f", "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/segments?ids=&parent_list_ids=&no_parent_list_id=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments" ], "query": [ { "description": "A list of segment IDs to retrieve. When this parameter is included, the `no_parent_list_ids` and `parent_list_ids` parameters are ignored and only segments with given IDs are returned.", "key": "ids", "value": "" }, { "description": "A comma separated list of list ids to be used when searching for segments with the specified parent_list_id, no more than 50 is allowed", "key": "parent_list_ids", "value": "" }, { "description": "If set to `true` segments with an empty value of `parent_list_id` will be returned in the filter. If the value is not present it defaults to 'false'.", "key": "no_parent_list_id", "value": "false" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-bcd0ba81-97d4-48dd-8001-c2356bddbe5f" }, { "id": "66b4aaa6-d812-489c-9c9b-12f138e362de", "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/segments?ids=&parent_list_ids=&no_parent_list_id=false", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "segments" ], "query": [ { "description": "A list of segment IDs to retrieve. When this parameter is included, the `no_parent_list_ids` and `parent_list_ids` parameters are ignored and only segments with given IDs are returned.", "key": "ids", "value": "" }, { "description": "A comma separated list of list ids to be used when searching for segments with the specified parent_list_id, no more than 50 is allowed", "key": "parent_list_ids", "value": "" }, { "description": "If set to `true` segments with an empty value of `parent_list_id` will be returned in the filter. If the value is not present it defaults to 'false'.", "key": "no_parent_list_id", "value": "false" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\"\n },\n {\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-66b4aaa6-d812-489c-9c9b-12f138e362de" } ], "createdAt": "2026-06-05T15:17:34.000Z", "updatedAt": "2026-06-05T15:17:34.000Z", "uid": "35240-3e6930e9-f583-4c1b-aa29-c927fdfefd76" } ], "id": "b765d129-ceb0-422f-adb7-d5fc29f66cf5", "createdAt": "2026-06-05T15:17:33.000Z", "updatedAt": "2026-06-05T15:17:33.000Z", "uid": "35240-b765d129-ceb0-422f-adb7-d5fc29f66cf5" } ], "id": "7534f356-333e-48a3-8517-39df67ddbd5d", "createdAt": "2026-06-05T15:17:33.000Z", "updatedAt": "2026-06-05T15:17:33.000Z", "uid": "35240-7534f356-333e-48a3-8517-39df67ddbd5d" } ], "id": "d4659ec3-0106-4e52-83d6-c2c943e7a34d", "createdAt": "2026-06-05T15:17:33.000Z", "updatedAt": "2026-06-05T15:17:33.000Z", "uid": "35240-d4659ec3-0106-4e52-83d6-c2c943e7a34d" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.sendgrid.com" } ] }