{ "info": { "_postman_id": "130a5b0f-b64f-4210-9c5a-44f02d269de6", "name": "Twilio SendGrid Marketing Campaigns Contacts API", "description": "The Twilio SendGrid Marketing Campaigns Contacts API allows you to manage all of your marketing contacts programmatically. You can also import and export contacts using this API. The Contacts API allows you to associate contacts with lists and segments; however, to manage the lists and segments themselves, see the [Lists API](https://docs.sendgrid.com/api-reference/lists/) and [Segments API](https://docs.sendgrid.com/api-reference/segmenting-contacts-v2/).\n\nYou can also manage your marketing contacts with the [Marketing Campaigns application user interface](https://mc.sendgrid.com/contacts). See [**How to Send Email with New Marketing Campaigns**](https://docs.sendgrid.com/ui/sending-email/how-to-send-email-with-marketing-campaigns) for more information.\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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "lastUpdatedBy": "35240", "uid": "35240-130a5b0f-b64f-4210-9c5a-44f02d269de6" }, "item": [ { "name": "v3", "item": [ { "name": "marketing", "item": [ { "name": "contacts", "item": [ { "name": "{id}", "item": [ { "name": "Get a Contact by ID", "id": "903f54b5-10c9-4a55-b386-a70f90e1210c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":id" ], "variable": [ { "id": "7bb3ffc8-b079-4634-9e30-153974b86060", "key": "id", "value": "", "description": "(Required) " } ] }, "description": "**This endpoint returns the full details and all fields for the specified contact**.\nThe \"Get Contacts by Identifier\" endpoint can be used to get the ID of a contact." }, "response": [ { "id": "12f07c16-8f1c-4652-b20b-4a59cc30b128", "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/contacts/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":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 \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_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 \"custom_fields\": {},\n \"_metadata\": {\n \"self\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-12f07c16-8f1c-4652-b20b-4a59cc30b128" }, { "id": "a95f2065-6a02-423f-a02b-4d49ea0627fe", "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/contacts/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":id" ], "variable": [ { "key": "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-a95f2065-6a02-423f-a02b-4d49ea0627fe" }, { "id": "5dea6bec-bd07-487c-8697-de8830a3441c", "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/contacts/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":id" ], "variable": [ { "key": "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-5dea6bec-bd07-487c-8697-de8830a3441c" }, { "id": "a833a7da-6e87-4b1d-8c39-dd791311ab57", "name": "response", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-a833a7da-6e87-4b1d-8c39-dd791311ab57" }, { "id": "6f9da8cb-4e7c-4c5d-8e81-ef4251b29df1", "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/contacts/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":id" ], "variable": [ { "key": "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-6f9da8cb-4e7c-4c5d-8e81-ef4251b29df1" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-903f54b5-10c9-4a55-b386-a70f90e1210c" } ], "id": "7be9f823-91a2-45ce-87e8-e8933ff13df7", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-7be9f823-91a2-45ce-87e8-e8933ff13df7" }, { "name": "batch", "item": [ { "name": "Get Batched Contacts by IDs", "id": "de0f387f-f2b1-443e-8982-073edfe4c2eb", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/batch", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "batch" ] }, "description": "**This endpoint is used to retrieve a set of contacts identified by their IDs.**\n\nThis can be more efficient endpoint to get contacts than making a series of individual `GET` requests to the \"Get a Contact by ID\" endpoint.\n\nYou can supply up to 100 IDs. Pass them into the `ids` field in your request body as an array or one or more strings.\n\nTwilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data." }, "response": [ { "id": "764e4afe-b2e3-46a1-904e-82676244f941", "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 \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/batch", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "batch" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": [\n {\n \"id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_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 \"custom_fields\": {},\n \"_metadata\": {\n \"self\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_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 \"custom_fields\": {},\n \"_metadata\": {\n \"self\": \"\"\n }\n }\n ]\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-764e4afe-b2e3-46a1-904e-82676244f941" }, { "id": "e12b1b7c-ee96-42c1-8619-d6f9e346629f", "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 \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/batch", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "batch" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-e12b1b7c-ee96-42c1-8619-d6f9e346629f" }, { "id": "73d67cfc-e1c1-4e4c-9735-01b2b5b983da", "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 \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/batch", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "batch" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-73d67cfc-e1c1-4e4c-9735-01b2b5b983da" }, { "id": "b1d1512d-4dc9-487b-aaec-053cf8f62712", "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 \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/batch", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "batch" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-b1d1512d-4dc9-487b-aaec-053cf8f62712" }, { "id": "bcaab5c0-abcc-48d1-9882-b1451736d72b", "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 \"ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/batch", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "batch" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-bcaab5c0-abcc-48d1-9882-b1451736d72b" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-de0f387f-f2b1-443e-8982-073edfe4c2eb" } ], "id": "4474ff64-70b5-47d1-b8b3-7b535024bc30", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-4474ff64-70b5-47d1-b8b3-7b535024bc30" }, { "name": "{contact_id}", "item": [ { "name": "identifiers", "item": [ { "name": "Delete a Contact Identifier", "id": "3b91b43b-032d-40cd-bb01-53bdad4330fb", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"identifier_type\": \"EXTERNALID\",\n \"identifier_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/:contact_id/identifiers", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":contact_id", "identifiers" ], "variable": [ { "id": "65684f4d-9870-4ab9-8073-cad450dabb31", "key": "contact_id", "value": "", "description": "(Required) Must be set to the `contact_id` of the contact you want to remove the identifier from." } ] }, "description": "**This endpoint can be used to delete one identifier from a contact.**\n\nDeletion jobs are processed asynchronously.\n\nNote this is different from deleting a contact. If the contact has only one identifier, the asynchronous request will fail. All contacts are required to have at least one identifier.\n\nThe request body field `identifier_type` must have a valid value of \"EMAIL\", \"PHONENUMBERID\", \"EXTERNALID\", or \"ANONYMOUSID\".\n" }, "response": [ { "id": "e25ce9bc-75f5-4f29-894a-4f19612938bc", "name": "response", "originalRequest": { "method": "DELETE", "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 \"identifier_type\": \"EXTERNALID\",\n \"identifier_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/:contact_id/identifiers", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":contact_id", "identifiers" ], "variable": [ { "key": "contact_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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-e25ce9bc-75f5-4f29-894a-4f19612938bc" }, { "id": "309c0a78-61b6-4e85-84a2-6e7f025046c6", "name": "response", "originalRequest": { "method": "DELETE", "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 \"identifier_type\": \"EXTERNALID\",\n \"identifier_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/:contact_id/identifiers", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":contact_id", "identifiers" ], "variable": [ { "key": "contact_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": []\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-309c0a78-61b6-4e85-84a2-6e7f025046c6" }, { "id": "2442f71a-d1ae-47cf-97b2-1af84734845c", "name": "response", "originalRequest": { "method": "DELETE", "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 \"identifier_type\": \"EXTERNALID\",\n \"identifier_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/:contact_id/identifiers", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":contact_id", "identifiers" ], "variable": [ { "key": "contact_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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-2442f71a-d1ae-47cf-97b2-1af84734845c" }, { "id": "5f72b7f1-ba4b-43a3-a9b5-d6c52eac1e10", "name": "response", "originalRequest": { "method": "DELETE", "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 \"identifier_type\": \"EXTERNALID\",\n \"identifier_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/:contact_id/identifiers", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":contact_id", "identifiers" ], "variable": [ { "key": "contact_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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-5f72b7f1-ba4b-43a3-a9b5-d6c52eac1e10" }, { "id": "59cbdd16-e250-4f6f-82b6-6b643afc353e", "name": "response", "originalRequest": { "method": "DELETE", "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 \"identifier_type\": \"EXTERNALID\",\n \"identifier_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/:contact_id/identifiers", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":contact_id", "identifiers" ], "variable": [ { "key": "contact_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 \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-59cbdd16-e250-4f6f-82b6-6b643afc353e" }, { "id": "b2f35813-95b9-4ca1-bd08-b6b041b5afd9", "name": "response", "originalRequest": { "method": "DELETE", "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 \"identifier_type\": \"EXTERNALID\",\n \"identifier_value\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/:contact_id/identifiers", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", ":contact_id", "identifiers" ], "variable": [ { "key": "contact_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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-b2f35813-95b9-4ca1-bd08-b6b041b5afd9" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-3b91b43b-032d-40cd-bb01-53bdad4330fb" } ], "id": "3ddf3371-15f0-48d1-8c0a-3e9a994924f4", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-3ddf3371-15f0-48d1-8c0a-3e9a994924f4" } ], "id": "601e5a1e-625a-4d56-ab9b-c03efba7feba", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-601e5a1e-625a-4d56-ab9b-c03efba7feba" }, { "name": "count", "item": [ { "name": "Get Total Contact Count", "id": "95bd9da2-f0aa-4a75-a192-83ee318444e4", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/count", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "count" ] }, "description": "**This endpoint returns the total number of contacts you have stored.**\n\n\nTwilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data." }, "response": [ { "id": "84efc73e-08b0-46f5-9450-2ec4e1f0112f", "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/contacts/count", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "count" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"contact_count\": \"\",\n \"billable_count\": 0,\n \"billable_breakdown\": {\n \"total\": \"\",\n \"breakdown\": {}\n }\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-84efc73e-08b0-46f5-9450-2ec4e1f0112f" }, { "id": "d084ea6c-fe55-426b-9478-538b8299f526", "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/contacts/count", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "count" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-d084ea6c-fe55-426b-9478-538b8299f526" }, { "id": "5459ff66-1f36-4b21-b926-5cf8e0749ed4", "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/contacts/count", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "count" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-5459ff66-1f36-4b21-b926-5cf8e0749ed4" }, { "id": "228f1b9d-5375-4cce-80be-fe851d016ea8", "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/contacts/count", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "count" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-228f1b9d-5375-4cce-80be-fe851d016ea8" }, { "id": "c6d1b073-44c9-407d-ad22-53c279d79cd8", "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/contacts/count", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "count" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-c6d1b073-44c9-407d-ad22-53c279d79cd8" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-95bd9da2-f0aa-4a75-a192-83ee318444e4" } ], "id": "e3141bdd-c809-4a94-a69e-6bd2801513cc", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-e3141bdd-c809-4a94-a69e-6bd2801513cc" }, { "name": "exports", "item": [ { "name": "{id}", "item": [ { "name": "Export Contacts Status", "id": "0304e593-9db6-4122-a7cb-4a66fbdfa9f9", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/exports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports", ":id" ], "variable": [ { "id": "906a65b1-c2e1-43af-8540-e6d67f3c6940", "key": "id", "value": "", "description": "(Required) " } ] }, "description": "**This endpoint can be used to check the status of a contact export job**. \n\nTo use this call, you will need the `id` from the \"Export Contacts\" call.\n\nIf you would like to download a list, take the `id` that is returned from the \"Export Contacts\" endpoint and make an API request here to get the `urls`. Once you have the list of URLs, make a `GET` request on each URL to download your CSV file(s).\n\nTwilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data." }, "response": [ { "id": "e79184a7-9fea-4678-ac77-c42384c4c4bb", "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/contacts/exports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports", ":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 \"status\": \"ready\",\n \"created_at\": \"\",\n \"updated_at\": \"\",\n \"expires_at\": \"\",\n \"completed_at\": \"\",\n \"urls\": [\n \"\",\n \"\"\n ],\n \"message\": \"\",\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\",\n \"count\": \"\"\n },\n \"contact_count\": \"\"\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-e79184a7-9fea-4678-ac77-c42384c4c4bb" }, { "id": "18f815d7-7475-4495-94b5-008d5ec71b7f", "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/contacts/exports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports", ":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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-18f815d7-7475-4495-94b5-008d5ec71b7f" }, { "id": "bb2253c3-0136-49c6-9b9b-18bc754ad183", "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/contacts/exports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports", ":id" ], "variable": [ { "key": "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-bb2253c3-0136-49c6-9b9b-18bc754ad183" }, { "id": "45bec71d-cc5d-4648-8af5-4982cbda54b2", "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/contacts/exports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports", ":id" ], "variable": [ { "key": "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-45bec71d-cc5d-4648-8af5-4982cbda54b2" }, { "id": "b89390f8-0c38-4031-b97e-6e34bf3b620b", "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/contacts/exports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports", ":id" ], "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 {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-b89390f8-0c38-4031-b97e-6e34bf3b620b" }, { "id": "844b3381-c74b-45ad-bc4c-f0724bb356b4", "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/contacts/exports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports", ":id" ], "variable": [ { "key": "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-844b3381-c74b-45ad-bc4c-f0724bb356b4" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-0304e593-9db6-4122-a7cb-4a66fbdfa9f9" } ], "id": "80d82524-3184-48e3-bbaa-6facdb0877aa", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-80d82524-3184-48e3-bbaa-6facdb0877aa" }, { "name": "Export Contacts", "id": "50956e24-1037-4b4b-94b5-5fa07da319bc", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_ids\": [\n \"\",\n \"\"\n ],\n \"notifications\": {\n \"email\": \"\"\n },\n \"file_type\": \"json\",\n \"max_file_size\": 5000\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] }, "description": "**Use this endpoint to export lists or segments of contacts**.\n\nIf you would just like to have a link to the exported list sent to your email set the `notifications.email` option to `true` in the `POST` payload.\n\nIf you would like to download the list, take the `id` that is returned and use the \"Export Contacts Status\" endpoint to get the `urls`. Once you have the list of URLs, make a `GET` request to each URL provided to download your CSV file(s).\n\nYou specify the segments and or/contact lists you wish to export by providing the relevant IDs in, respectively, the `segment_ids` and `list_ids` fields in the request body.\n\nThe lists will be provided in either JSON or CSV files. To specify which of these you would required, set the request body `file_type` field to `json` or `csv`.\n\nYou can also specify a maximum file size (in MB). If the export file is larger than this, it will be split into multiple files." }, "response": [ { "id": "b2f33d66-c26a-44fb-a15d-8cb1f55a35ed", "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 \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_ids\": [\n \"\",\n \"\"\n ],\n \"notifications\": {\n \"email\": \"\"\n },\n \"file_type\": \"json\",\n \"max_file_size\": 5000\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\",\n \"count\": \"\"\n },\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-b2f33d66-c26a-44fb-a15d-8cb1f55a35ed" }, { "id": "44b892c8-8419-4fc9-8d9b-cb694d695dc5", "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 \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_ids\": [\n \"\",\n \"\"\n ],\n \"notifications\": {\n \"email\": \"\"\n },\n \"file_type\": \"json\",\n \"max_file_size\": 5000\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-44b892c8-8419-4fc9-8d9b-cb694d695dc5" }, { "id": "58d6e0c6-854c-41b1-9bf4-08e158a2362a", "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 \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_ids\": [\n \"\",\n \"\"\n ],\n \"notifications\": {\n \"email\": \"\"\n },\n \"file_type\": \"json\",\n \"max_file_size\": 5000\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-58d6e0c6-854c-41b1-9bf4-08e158a2362a" }, { "id": "f343596e-3b4c-4db5-a240-717b7cdc0ba1", "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 \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_ids\": [\n \"\",\n \"\"\n ],\n \"notifications\": {\n \"email\": \"\"\n },\n \"file_type\": \"json\",\n \"max_file_size\": 5000\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-f343596e-3b4c-4db5-a240-717b7cdc0ba1" }, { "id": "b96144d5-8bc5-439c-8c5c-e2c96b0c2c27", "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 \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_ids\": [\n \"\",\n \"\"\n ],\n \"notifications\": {\n \"email\": \"\"\n },\n \"file_type\": \"json\",\n \"max_file_size\": 5000\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-b96144d5-8bc5-439c-8c5c-e2c96b0c2c27" }, { "id": "94d25e69-5656-4c3e-b2bf-b671f28eeebc", "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 \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_ids\": [\n \"\",\n \"\"\n ],\n \"notifications\": {\n \"email\": \"\"\n },\n \"file_type\": \"json\",\n \"max_file_size\": 5000\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-94d25e69-5656-4c3e-b2bf-b671f28eeebc" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-50956e24-1037-4b4b-94b5-5fa07da319bc" }, { "name": "Get All Existing Exports", "id": "6b7b8128-f5b2-46b1-b94f-e91b69a954c3", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] }, "description": "**Use this endpoint to retrieve details of all current exported jobs**.\n\nIt will return an array of objects, each of which records an export job in flight or recently completed. \n\nEach object's `export_type` field will tell you which kind of export it is and its `status` field will indicate what stage of processing it has reached. Exports which are `ready` will be accompanied by a `urls` field which lists the URLs of the export's downloadable files \u2014 there will be more than one if you specified a maximum file size in your initial export request.\n\nUse this endpoint if you have exports in flight but do not know their IDs, which are required for the \"Export Contacts Status\" endpoint." }, "response": [ { "id": "23e55841-f4fa-4bfa-8760-180dba4a1852", "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/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": [\n {\n \"id\": \"\",\n \"status\": \"\",\n \"created_at\": \"\",\n \"completed_at\": \"\",\n \"expires_at\": \"\",\n \"urls\": [\n \"\",\n \"\"\n ],\n \"user_id\": \"\",\n \"export_type\": \"\",\n \"segments\": [\n {\n \"ID\": \"\",\n \"Name\": \"\"\n },\n {\n \"ID\": \"\",\n \"Name\": \"\"\n }\n ],\n \"lists\": [\n {\n \"ID\": \"\",\n \"Name\": \"\"\n },\n {\n \"ID\": \"\",\n \"Name\": \"\"\n }\n ],\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"status\": \"\",\n \"created_at\": \"\",\n \"completed_at\": \"\",\n \"expires_at\": \"\",\n \"urls\": [\n \"\",\n \"\"\n ],\n \"user_id\": \"\",\n \"export_type\": \"\",\n \"segments\": [\n {\n \"ID\": \"\",\n \"Name\": \"\"\n },\n {\n \"ID\": \"\",\n \"Name\": \"\"\n }\n ],\n \"lists\": [\n {\n \"ID\": \"\",\n \"Name\": \"\"\n },\n {\n \"ID\": \"\",\n \"Name\": \"\"\n }\n ],\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\"\n }\n }\n ],\n \"_metadata\": {\n \"prev\": \"\",\n \"self\": \"\",\n \"next\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-23e55841-f4fa-4bfa-8760-180dba4a1852" }, { "id": "8d3ebe08-bef0-45aa-9665-4a5815bc697f", "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/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "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 \"error_id\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-8d3ebe08-bef0-45aa-9665-4a5815bc697f" }, { "id": "74acc031-8de9-4994-964f-bf17dabe8286", "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/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-74acc031-8de9-4994-964f-bf17dabe8286" }, { "id": "c687dc46-3c8b-4c47-95ca-c2181513c6da", "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/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-c687dc46-3c8b-4c47-95ca-c2181513c6da" }, { "id": "e7850790-3315-4058-a670-e0b7f3cae47a", "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/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-e7850790-3315-4058-a670-e0b7f3cae47a" }, { "id": "02959a58-c26f-4c58-a879-4028c2d17d85", "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/contacts/exports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "exports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-02959a58-c26f-4c58-a879-4028c2d17d85" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-6b7b8128-f5b2-46b1-b94f-e91b69a954c3" } ], "id": "84de0e48-dc25-49c1-85ca-c65ef1d71ef2", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-84de0e48-dc25-49c1-85ca-c65ef1d71ef2" }, { "name": "imports", "item": [ { "name": "{id}", "item": [ { "name": "Import Contacts Status", "id": "ddbc42ff-d712-4776-a9cd-527121775922", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/imports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports", ":id" ], "variable": [ { "id": "f8cdfbfc-3b9e-432e-bce7-bce6d88ebc5e", "key": "id", "value": "", "description": "(Required) " } ] }, "description": "**This endpoint can be used to check the status of a contact import job**. \n\nUse the `job_id` from the \"Import Contacts,\" \"Add or Update a Contact,\" or \"Delete Contacts\" endpoints as the `id` in the path parameter.\n\nIf there is an error with your `PUT` request, download the `errors_url` file and open it to view more details.\n\nThe job `status` field indicates whether the job is `pending`, `completed`, `errored`, or `failed`. \n\nPending means not started. Completed means finished without any errors. Errored means finished with some errors. Failed means finished with all errors, or the job was entirely unprocessable: for example, if you attempt to import file format we do not support.\n\nThe `results` object will have fields depending on the job type.\n\nTwilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data." }, "response": [ { "id": "9b80d464-3a45-432b-9b81-6e2bc89d9470", "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/contacts/imports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports", ":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 \"status\": \"\",\n \"job_type\": \"\",\n \"results\": {\n \"requested_count\": \"\",\n \"created_count\": \"\",\n \"updated_count\": \"\",\n \"deleted_count\": \"\",\n \"errored_count\": \"\",\n \"errors_url\": \"\"\n },\n \"started_at\": \"\",\n \"finished_at\": \"\"\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-9b80d464-3a45-432b-9b81-6e2bc89d9470" }, { "id": "d4e37fb3-3622-4a96-8ff6-0e69b00f88f6", "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/contacts/imports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports", ":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 \"message\": \"\",\n \"field\": \"\",\n \"error_id\": \"\",\n \"parameter\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-d4e37fb3-3622-4a96-8ff6-0e69b00f88f6" }, { "id": "941cab6c-d6fd-4ad8-aa85-dd5446550394", "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/contacts/imports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports", ":id" ], "variable": [ { "key": "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-941cab6c-d6fd-4ad8-aa85-dd5446550394" }, { "id": "a6c58d81-8254-468a-9a2f-35f8952f9843", "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/contacts/imports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports", ":id" ], "variable": [ { "key": "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-a6c58d81-8254-468a-9a2f-35f8952f9843" }, { "id": "cab98bb3-d34a-400b-91cf-21b9f202b56d", "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/contacts/imports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports", ":id" ], "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 {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-cab98bb3-d34a-400b-91cf-21b9f202b56d" }, { "id": "62bf046e-5072-4fb6-b1fe-2759d16065a8", "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/contacts/imports/:id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports", ":id" ], "variable": [ { "key": "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-62bf046e-5072-4fb6-b1fe-2759d16065a8" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-ddbc42ff-d712-4776-a9cd-527121775922" } ], "id": "963fac63-8adb-4b04-9f97-c4fe28f4890a", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-963fac63-8adb-4b04-9f97-c4fe28f4890a" }, { "name": "Import Contacts", "id": "c59a968a-b4c6-4c0d-a987-6dd55339fa06", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"file_type\": \"csv\",\n \"field_mappings\": [\n \"\"\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/imports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports" ] }, "description": "**This endpoint allows a CSV upload containing up to one million contacts or 5GB of data, whichever is smaller. At least one identifier is required for a successful import.**\n\nImports take place asynchronously: the endpoint returns a URL (`upload_uri`) and HTTP headers (`upload_headers`) which can subsequently be used to `PUT` a file of contacts to be imported into our system.\n\nUploaded CSV files may also be [gzip-compressed](https://en.wikipedia.org/wiki/Gzip).\n\nIn either case, you must include the field `file_type` with the value `csv` in your request body.\n\nThe `field_mappings` parameter is a respective list of field definition IDs to map the uploaded CSV columns to. It allows you to use CSVs where one or more columns are skipped (`null`) or remapped to the contact field.\n\nFor example, if `field_mappings` is set to `[null, \"w1\", \"_rf1\"]`, this means skip column 0, map column 1 to the custom field with the ID `w1`, and map column 2 to the reserved field with the ID `_rf1`. See the \"Get All Field Definitions\" endpoint to fetch your custom and reserved field IDs to use with `field_mappings`.\n\nOnce you receive the response body you can then initiate a **second** API call where you use the supplied URL and HTTP header to upload your file. For example:\n\n`curl --upload-file \"file/path.csv\" \"URL_GIVEN\" -H \"HEADER_GIVEN\"`\n\nIf you would like to monitor the status of your import job, use the `job_id` and the \"Import Contacts Status\" endpoint.\n\nTwilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data.\n" }, "response": [ { "id": "053b4a82-ec64-48e0-bba1-6ca556af0b24", "name": "response", "originalRequest": { "method": "PUT", "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 \"file_type\": \"csv\",\n \"field_mappings\": [\n \"\"\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/imports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"job_id\": \"\",\n \"upload_uri\": \"\",\n \"upload_headers\": [\n {\n \"header\": \"\",\n \"value\": \"\"\n },\n {\n \"header\": \"\",\n \"value\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-053b4a82-ec64-48e0-bba1-6ca556af0b24" }, { "id": "e5e82b55-73dc-4b99-bc3b-a35987bcc07a", "name": "response", "originalRequest": { "method": "PUT", "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 \"file_type\": \"csv\",\n \"field_mappings\": [\n \"\"\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/imports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-e5e82b55-73dc-4b99-bc3b-a35987bcc07a" }, { "id": "deb174b1-eea7-49ef-ad0c-d2577b18234c", "name": "response", "originalRequest": { "method": "PUT", "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 \"file_type\": \"csv\",\n \"field_mappings\": [\n \"\"\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/imports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-deb174b1-eea7-49ef-ad0c-d2577b18234c" }, { "id": "6d94587a-afbd-4d65-aeb6-271d7681e7c7", "name": "response", "originalRequest": { "method": "PUT", "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 \"file_type\": \"csv\",\n \"field_mappings\": [\n \"\"\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/imports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-6d94587a-afbd-4d65-aeb6-271d7681e7c7" }, { "id": "13e0e468-d09c-4cd1-a7f3-c177b958cdd8", "name": "response", "originalRequest": { "method": "PUT", "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 \"file_type\": \"csv\",\n \"field_mappings\": [\n \"\"\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/imports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports" ] } }, "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 \"error_id\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"error_id\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-13e0e468-d09c-4cd1-a7f3-c177b958cdd8" }, { "id": "c0494b55-3d85-48dd-aa38-c3fee6966e3a", "name": "response", "originalRequest": { "method": "PUT", "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 \"file_type\": \"csv\",\n \"field_mappings\": [\n \"\"\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/imports", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "imports" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-c0494b55-3d85-48dd-aa38-c3fee6966e3a" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-c59a968a-b4c6-4c0d-a987-6dd55339fa06" } ], "id": "234636d2-5fc1-4ab5-aee2-512b8f1f913c", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-234636d2-5fc1-4ab5-aee2-512b8f1f913c" }, { "name": "search", "item": [ { "name": "emails", "item": [ { "name": "Get Contacts by Emails", "id": "125a3117-44f8-49b4-af21-614fa93026cc", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"emails\": [\n \"\",\n \"\"\n ],\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/emails", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "emails" ] }, "description": "**This endpoint allows you to retrieve up to 100 contacts matching the searched `email` address(es), including any `alternate_emails`.** \n\nEmail addresses are unique to a contact, meaning this endpoint can treat an email address as a primary key to search by. The contact object associated with the address, whether it is their `email` or one of their `alternate_emails` will be returned if matched.\n\nEmail addresses in the search request do not need to match the case in which they're stored, but the email addresses in the result will be all lower case. Empty strings are excluded from the search and will not be returned.\n\nThis endpoint should be used in place of the \"Search Contacts\" endpoint when you can provide exact email addresses and do not need to include other [Segmentation Query Language (SGQL)](https://sendgrid.com/docs/for-developers/sending-email/segmentation-query-language/) filters when searching.\n\nIf you need to access a large percentage of your contacts, we recommend exporting your contacts with the \"Export Contacts\" endpoint and filtering the client side results.\n\nThis endpoint returns a `200` status code when any contacts match the address(es) you supplied. When searching multiple addresses in a single request, it is possible that some addresses will match a contact while others will not. When a partially successful search like this is made, the matching contacts are returned in an object and an error message is returned for the email address(es) that are not found. \n\nThis endpoint returns a `404` status code when no contacts are found for the provided email address(es).\n\nA `400` status code is returned if any searched addresses are invalid.\n\nTwilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data." }, "response": [ { "id": "3bc8ff07-2604-4d13-8866-ffcf1b115d6b", "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 \"emails\": [\n \"\",\n \"\"\n ],\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/emails", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "emails" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": {\n \"8B@NiDl1YM0.Kgt\": {\n \"contact\": {},\n \"error\": \"elit sunt e\"\n }\n }\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-3bc8ff07-2604-4d13-8866-ffcf1b115d6b" }, { "id": "9b81f7e8-6938-4ce0-8907-62f88142de62", "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 \"emails\": [\n \"\",\n \"\"\n ],\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/emails", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "emails" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-9b81f7e8-6938-4ce0-8907-62f88142de62" }, { "id": "a85b6a5b-e41c-4f62-be86-23acd92eb43d", "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 \"emails\": [\n \"\",\n \"\"\n ],\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/emails", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "emails" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-a85b6a5b-e41c-4f62-be86-23acd92eb43d" }, { "id": "8948dbd1-5338-4421-911a-1465b8e854ad", "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 \"emails\": [\n \"\",\n \"\"\n ],\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/emails", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "emails" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-8948dbd1-5338-4421-911a-1465b8e854ad" }, { "id": "ed7c6921-0576-4b25-ac15-49b04ef685fc", "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 \"emails\": [\n \"\",\n \"\"\n ],\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/emails", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "emails" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-ed7c6921-0576-4b25-ac15-49b04ef685fc" }, { "id": "eef2178f-7aab-4e02-a53a-ab270aa21003", "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 \"emails\": [\n \"\",\n \"\"\n ],\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/emails", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "emails" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-eef2178f-7aab-4e02-a53a-ab270aa21003" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-125a3117-44f8-49b4-af21-614fa93026cc" } ], "id": "7f3d1fcf-2c30-442a-b7c6-0cb48c7e6465", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-7f3d1fcf-2c30-442a-b7c6-0cb48c7e6465" }, { "name": "identifiers", "item": [ { "name": "{identifier_type}", "item": [ { "name": "Get Contacts by Identifiers", "id": "cb95f954-8e73-4255-a0b1-32fab724f3a2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/identifiers/:identifier_type", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "identifiers", ":identifier_type" ], "variable": [ { "id": "a36f46ea-cb30-4987-88b1-61f53f30ece4", "key": "identifier_type", "value": "external_id", "description": "(Required) The type of identifier to search for. You can use only one type of identifier per search." } ] }, "description": "Use this endpoint to retrieve up to 100 contacts that match the requested identifier values for a single identifier type.\n\n`identifier_type` must be a valid identifier type: `email`, `phone_number_id`, `external_id`, or `anonymous_id`.\n\nUse this endpoint instead of the [Search Contacts endpoint](https://www.twilio.com/docs/sendgrid/api-reference/contacts/search-contacts) when you can provide exact identifiers and do not need to include other [Segmentation Query Language (SGQL)](https://www.twilio.com/docs/sendgrid/for-developers/sending-email/segmentation-query-language/) filters when searching.\n\nThis endpoint returns a `200` status code when any contacts match the identifiers you supplied. When searching multiple identifier values in a single request, it is possible that some will match a contact while others will not. When a partially successful search like this is made, the matching contacts are returned in an object and an error message is returned for the identifier values that are not found.\n\nThis endpoint returns a `404` status code when no contacts are found for the provided identifiers.\n\nThis endpoint returns a `400` status code if any searched addresses are invalid.\n\nTwilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data.\n" }, "response": [ { "id": "a34731d5-24c7-4e64-b94f-24a2ad0532ab", "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 \"identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/identifiers/:identifier_type", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "identifiers", ":identifier_type" ], "variable": [ { "key": "identifier_type" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": {\n \"minim__d1\": {\n \"contact\": {\n \"id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_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 \"custom_fields\": {},\n \"_metadata\": {\n \"self\": \"\"\n }\n },\n \"error\": \"\"\n },\n \"nonec\": {\n \"contact\": {\n \"id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_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 \"custom_fields\": {},\n \"_metadata\": {\n \"self\": \"\"\n }\n },\n \"error\": \"\"\n }\n }\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-a34731d5-24c7-4e64-b94f-24a2ad0532ab" }, { "id": "530e8164-d84d-4b2a-ab82-bd131c259128", "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 \"identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/identifiers/:identifier_type", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "identifiers", ":identifier_type" ], "variable": [ { "key": "identifier_type" } ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-530e8164-d84d-4b2a-ab82-bd131c259128" }, { "id": "7ba23fb4-29d3-4979-84cb-cf9fe7a408e1", "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 \"identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/identifiers/:identifier_type", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "identifiers", ":identifier_type" ], "variable": [ { "key": "identifier_type" } ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-7ba23fb4-29d3-4979-84cb-cf9fe7a408e1" }, { "id": "fc12dcf7-2560-4a52-916d-d6c62dc2dd08", "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 \"identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/identifiers/:identifier_type", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "identifiers", ":identifier_type" ], "variable": [ { "key": "identifier_type" } ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-fc12dcf7-2560-4a52-916d-d6c62dc2dd08" }, { "id": "a4031031-8618-4cb4-9657-5a84587fcbc5", "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 \"identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/identifiers/:identifier_type", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "identifiers", ":identifier_type" ], "variable": [ { "key": "identifier_type" } ] } }, "status": "Not Found", "code": 404, "_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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-a4031031-8618-4cb4-9657-5a84587fcbc5" }, { "id": "b6a867cf-b3b3-48b4-a03e-ebf4a63bbde5", "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 \"identifiers\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search/identifiers/:identifier_type", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search", "identifiers", ":identifier_type" ], "variable": [ { "key": "identifier_type" } ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-b6a867cf-b3b3-48b4-a03e-ebf4a63bbde5" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-cb95f954-8e73-4255-a0b1-32fab724f3a2" } ], "id": "4786a6a4-f533-432f-903f-4a0ac6f9cf20", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-4786a6a4-f533-432f-903f-4a0ac6f9cf20" } ], "id": "b3d544f4-bf69-4606-bb19-42dc0f47d1e9", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-b3d544f4-bf69-4606-bb19-42dc0f47d1e9" }, { "name": "Search Contacts", "id": "15a4baae-c426-4445-a87f-27f46d0745ba", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"query\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search" ] }, "description": "**Use this endpoint to locate contacts**.\n\nThe request body's `query` field accepts valid [SGQL](https://sendgrid.com/docs/for-developers/sending-email/segmentation-query-language/) for searching for a contact.\n\nBecause contact emails are stored in lower case, using SGQL to search by email address requires the provided email address to be in lower case. The SGQL `lower()` function can be used for this.\n\nOnly the first 50 contacts that meet the search criteria will be returned.\n\nIf the query takes longer than 20 seconds, a `408 Request Timeout` status will be returned.\n\nFormatting the `created_at` and `updated_at` values as Unix timestamps is deprecated. Instead, they are returned as ISO format as string." }, "response": [ { "id": "0df1631e-b66c-4944-9777-a1632c3a94a8", "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 \"query\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"contact_count\": \"\",\n \"result\": [\n {\n \"id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_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 \"custom_fields\": {},\n \"_metadata\": {\n \"self\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_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 \"custom_fields\": {},\n \"_metadata\": {\n \"self\": \"\"\n }\n }\n ],\n \"_metadata\": {\n \"self\": \"\"\n }\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-0df1631e-b66c-4944-9777-a1632c3a94a8" }, { "id": "00387707-b92c-4fe7-bc58-1f1bd566532a", "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 \"query\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"field\": \"\",\n \"message\": \"\"\n },\n {\n \"field\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-00387707-b92c-4fe7-bc58-1f1bd566532a" }, { "id": "403e0fff-6076-4a93-a355-bed6515cd25b", "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 \"query\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-403e0fff-6076-4a93-a355-bed6515cd25b" }, { "id": "d7d19f65-bb9c-4fe3-b8b2-9f622ba73322", "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 \"query\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-d7d19f65-bb9c-4fe3-b8b2-9f622ba73322" }, { "id": "31ab4b6a-8576-4205-b859-644d3107d7b5", "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 \"query\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-31ab4b6a-8576-4205-b859-644d3107d7b5" }, { "id": "504c072c-8fc2-414f-8947-7fdbef4e090a", "name": "response", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"query\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search" ] } }, "status": "Request Timeout", "code": 408, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-504c072c-8fc2-414f-8947-7fdbef4e090a" }, { "id": "d02f7f52-7ac8-4d73-a74f-e1e953d16b49", "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 \"query\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts/search", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts", "search" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-d02f7f52-7ac8-4d73-a74f-e1e953d16b49" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-15a4baae-c426-4445-a87f-27f46d0745ba" } ], "id": "7cf54ddf-8817-47d1-9549-799cab644de9", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-7cf54ddf-8817-47d1-9549-799cab644de9" }, { "name": "Add or Update a Contact", "id": "57524422-287a-443e-9090-d86a3f0c6755", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"contacts\": [\n {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"alternate_emails\": [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n \"city\": \"\",\n \"country\": \"\",\n \"email\": \"\",\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"postal_code\": \"\",\n \"state_province_region\": \"\",\n \"custom_fields\": {\n \"w1\": \"\"\n }\n }\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] }, "description": "**This endpoint allows the [upsert](https://en.wiktionary.org/wiki/upsert) (insert or update) of up to 30,000 contacts, or 6MB of data, whichever is lower**.\nBecause the creation and update of contacts is an asynchronous process, the response will not contain immediate feedback on the processing of your upserted contacts. Rather, it will contain an HTTP 202 response indicating the contacts are queued for processing or an HTTP 4XX error containing validation errors. Should you wish to get the resulting contact's ID or confirm that your contacts have been updated or added, you can use the [Get Contacts by Identifiers operation](https://www.twilio.com/docs/sendgrid/api-reference/contacts/get-contacts-by-identifiers).\nPlease note that custom fields need to have been already created if you wish to set their values for the contacts being upserted. To do this, please use the [Create Custom Field Definition endpoint](https://www.twilio.com/docs/sendgrid/api-reference/custom-fields/create-custom-field-definition).\nYou will see a `job_id` in the response to your request. This can be used to check the status of your upsert job. To do so, please use the [Import Contacts Status endpoint](https://www.twilio.com/docs/sendgrid/api-reference/contacts/import-contacts-status).\nIf the contact already exists in the system, any entries submitted via this endpoint will update the existing contact. In order to update a contact, all of its existing identifiers must be present. Any fields omitted from the request will remain as they were. A contact's ID cannot be used to update the contact.\nThe email field will be changed to all lower-case. If a contact is added with an email that exists but contains capital letters, the existing contact with the all lower-case email will be updated." }, "response": [ { "id": "441e54bf-fe57-40b2-a071-2a227660809f", "name": "response", "originalRequest": { "method": "PUT", "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 \"contacts\": [\n {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"alternate_emails\": [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n \"city\": \"\",\n \"country\": \"\",\n \"email\": \"\",\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"postal_code\": \"\",\n \"state_province_region\": \"\",\n \"custom_fields\": {\n \"w1\": \"\"\n }\n }\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-441e54bf-fe57-40b2-a071-2a227660809f" }, { "id": "e8f7cb1e-78aa-425f-8bb9-b6275def9c4f", "name": "response", "originalRequest": { "method": "PUT", "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 \"contacts\": [\n {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"alternate_emails\": [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n \"city\": \"\",\n \"country\": \"\",\n \"email\": \"\",\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"postal_code\": \"\",\n \"state_province_region\": \"\",\n \"custom_fields\": {\n \"w1\": \"\"\n }\n }\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-e8f7cb1e-78aa-425f-8bb9-b6275def9c4f" }, { "id": "29e1ca47-623f-4ba1-8828-a3029f61639f", "name": "response", "originalRequest": { "method": "PUT", "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 \"contacts\": [\n {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"alternate_emails\": [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n \"city\": \"\",\n \"country\": \"\",\n \"email\": \"\",\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"postal_code\": \"\",\n \"state_province_region\": \"\",\n \"custom_fields\": {\n \"w1\": \"\"\n }\n }\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-29e1ca47-623f-4ba1-8828-a3029f61639f" }, { "id": "2d50da2f-3846-40b1-a1c6-773261fc6a47", "name": "response", "originalRequest": { "method": "PUT", "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 \"contacts\": [\n {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"alternate_emails\": [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n \"city\": \"\",\n \"country\": \"\",\n \"email\": \"\",\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"postal_code\": \"\",\n \"state_province_region\": \"\",\n \"custom_fields\": {\n \"w1\": \"\"\n }\n }\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-2d50da2f-3846-40b1-a1c6-773261fc6a47" }, { "id": "a1278f44-9878-48a6-9bf6-04c5c8d5568b", "name": "response", "originalRequest": { "method": "PUT", "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 \"contacts\": [\n {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"alternate_emails\": [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n \"city\": \"\",\n \"country\": \"\",\n \"email\": \"\",\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"postal_code\": \"\",\n \"state_province_region\": \"\",\n \"custom_fields\": {\n \"w1\": \"\"\n }\n }\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-a1278f44-9878-48a6-9bf6-04c5c8d5568b" }, { "id": "120b0c19-e8af-44c6-8022-3261371b3bf6", "name": "response", "originalRequest": { "method": "PUT", "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 \"contacts\": [\n {\n \"address_line_1\": \"\",\n \"address_line_2\": \"\",\n \"alternate_emails\": [\n \"\",\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n \"city\": \"\",\n \"country\": \"\",\n \"email\": \"\",\n \"phone_number_id\": \"\",\n \"external_id\": \"\",\n \"anonymous_id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"postal_code\": \"\",\n \"state_province_region\": \"\",\n \"custom_fields\": {\n \"w1\": \"\"\n }\n }\n ],\n \"list_ids\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/marketing/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-120b0c19-e8af-44c6-8022-3261371b3bf6" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-57524422-287a-443e-9090-d86a3f0c6755" }, { "name": "Delete Contacts", "id": "504ab1b2-27c9-4084-9021-917cd87c8e28", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/contacts?delete_all_contacts=&ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ], "query": [ { "description": "Must be set to `\"true\"` to delete all contacts.", "key": "delete_all_contacts", "value": "" }, { "description": "A comma-separated list of contact IDs.", "key": "ids", "value": "" } ] }, "description": "**This endpoint can be used to delete one or more contacts**.\n\nThe query parameter `ids` must set to a comma-separated list of contact IDs for bulk contact deletion.\n\nThe query parameter `delete_all_contacts` must be set to `\"true\"` to delete **all** contacts. \n\nYou must set either `ids` or `delete_all_contacts`.\n\nDeletion jobs are processed asynchronously.\n\nTwilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data." }, "response": [ { "id": "fc7343bb-f51e-4192-9174-3ac846df5fc2", "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/contacts?delete_all_contacts=&ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ], "query": [ { "description": "Must be set to `\"true\"` to delete all contacts.", "key": "delete_all_contacts", "value": "" }, { "description": "A comma-separated list of contact IDs.", "key": "ids", "value": "" } ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-fc7343bb-f51e-4192-9174-3ac846df5fc2" }, { "id": "85e858a2-84d1-4283-892e-2c456f430bdc", "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/contacts?delete_all_contacts=&ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ], "query": [ { "description": "Must be set to `\"true\"` to delete all contacts.", "key": "delete_all_contacts", "value": "" }, { "description": "A comma-separated list of contact IDs.", "key": "ids", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": []\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-85e858a2-84d1-4283-892e-2c456f430bdc" }, { "id": "bc356377-a3a5-432a-ac00-0572c5fe7950", "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/contacts?delete_all_contacts=&ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ], "query": [ { "description": "Must be set to `\"true\"` to delete all contacts.", "key": "delete_all_contacts", "value": "" }, { "description": "A comma-separated list of contact IDs.", "key": "ids", "value": "" } ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-bc356377-a3a5-432a-ac00-0572c5fe7950" }, { "id": "c8d9fa60-d34c-4311-bb52-b0ff0678aa63", "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/contacts?delete_all_contacts=&ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ], "query": [ { "description": "Must be set to `\"true\"` to delete all contacts.", "key": "delete_all_contacts", "value": "" }, { "description": "A comma-separated list of contact IDs.", "key": "ids", "value": "" } ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-c8d9fa60-d34c-4311-bb52-b0ff0678aa63" }, { "id": "8af1ca20-a82d-41f2-be55-5dfe21aa7fe7", "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/contacts?delete_all_contacts=&ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ], "query": [ { "description": "Must be set to `\"true\"` to delete all contacts.", "key": "delete_all_contacts", "value": "" }, { "description": "A comma-separated list of contact IDs.", "key": "ids", "value": "" } ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-8af1ca20-a82d-41f2-be55-5dfe21aa7fe7" }, { "id": "19b2728b-891e-48f7-a488-b7ea41c7b8bc", "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/contacts?delete_all_contacts=&ids=", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ], "query": [ { "description": "Must be set to `\"true\"` to delete all contacts.", "key": "delete_all_contacts", "value": "" }, { "description": "A comma-separated list of contact IDs.", "key": "ids", "value": "" } ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-19b2728b-891e-48f7-a488-b7ea41c7b8bc" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-504ab1b2-27c9-4084-9021-917cd87c8e28" }, { "name": "Get Sample Contacts", "id": "f617a16a-9741-4888-ad77-2d044098798a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/marketing/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] }, "description": "**This endpoint will return up to 50 of the most recent contacts uploaded or attached to a list**. \n\nThis list will then be sorted by email address.\n\nThe full contact count is also returned.\n\nPlease note that pagination of the contacts has been deprecated.\n\nTwilio SendGrid recommends exporting your contacts regularly as a backup to avoid issues or lost data." }, "response": [ { "id": "fd1e6fa3-3e5c-47f2-8e6d-b5873ca090f0", "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/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": [\n {\n \"id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_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 \"custom_fields\": {},\n \"_metadata\": {\n \"self\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"list_ids\": [\n \"\",\n \"\"\n ],\n \"segment_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 \"custom_fields\": {},\n \"_metadata\": {\n \"self\": \"\"\n }\n }\n ],\n \"_metadata\": {\n \"self\": \"\"\n },\n \"contact_count\": \"\"\n}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-fd1e6fa3-3e5c-47f2-8e6d-b5873ca090f0" }, { "id": "f194175b-57e8-45f1-a676-13181bd8ac28", "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/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-f194175b-57e8-45f1-a676-13181bd8ac28" }, { "id": "da762640-3a2f-4b43-b45b-8b0e017f8d20", "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/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-da762640-3a2f-4b43-b45b-8b0e017f8d20" }, { "id": "e48de968-9638-47b0-b826-e20d5d739b77", "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/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-e48de968-9638-47b0-b826-e20d5d739b77" }, { "id": "7834d57c-c361-4edb-b615-15b35af67423", "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/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-7834d57c-c361-4edb-b615-15b35af67423" }, { "id": "a0f9b50a-ba60-49a1-aa92-f1170a8d93af", "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/contacts", "host": [ "{{baseUrl}}" ], "path": [ "v3", "marketing", "contacts" ] } }, "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:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-a0f9b50a-ba60-49a1-aa92-f1170a8d93af" } ], "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-f617a16a-9741-4888-ad77-2d044098798a" } ], "id": "5b43a091-6d04-4174-b140-71385a2c21b5", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-5b43a091-6d04-4174-b140-71385a2c21b5" } ], "id": "c976967f-7f3b-4ee4-bce1-8fb8a136c81e", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-c976967f-7f3b-4ee4-bce1-8fb8a136c81e" } ], "id": "25b7d7b8-efc5-41e2-af6e-c5e1987285c0", "createdAt": "2026-06-05T15:17:27.000Z", "updatedAt": "2026-06-05T15:17:27.000Z", "uid": "35240-25b7d7b8-efc5-41e2-af6e-c5e1987285c0" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.sendgrid.com" } ] }