{ "info": { "_postman_id": "b892a055-bc5e-4f6c-ac1a-12f2e8c18169", "name": "Twilio SendGrid Legacy Marketing Campaigns Sender Identities API", "description": "The Twilio SendGrid Legacy Marketing Campaigns Sender Identites API allows you to manage the email addresses used to send your marketing email. This API is operational, but we recommend using the current version of Marketing Campaigns to manage your [senders](https://docs.sendgrid.com/api-reference/senders/).\n\nSee [**Migrating from Legacy Marketing Campaigns**](https://docs.sendgrid.com/ui/sending-email/migrating-from-legacy-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:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "lastUpdatedBy": "35240", "uid": "35240-b892a055-bc5e-4f6c-ac1a-12f2e8c18169" }, "item": [ { "name": "v3", "item": [ { "name": "senders", "item": [ { "name": "{sender_id}", "item": [ { "name": "resend_verification", "item": [ { "name": "Resend Sender Identity Verification", "id": "eb763a30-b445-4fd7-a573-b3e24f1c3258", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id/resend_verification", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id", "resend_verification" ], "variable": [ { "id": "6581d6ca-840c-49ab-a260-8568253bdc9b", "key": "sender_id", "value": "", "description": "(Required) The ID of the sender identity for which you would like to resend a verification email." } ] }, "description": "**This endpoint allows you to resend a sender identity verification email.**" }, "response": [ { "id": "9607ed2d-28b2-4aa8-aeac-563ddf2bb8f8", "name": "response", "originalRequest": { "method": "POST", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id/resend_verification", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id", "resend_verification" ], "variable": [ { "key": "sender_id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-9607ed2d-28b2-4aa8-aeac-563ddf2bb8f8" }, { "id": "f348174c-015c-4c0c-b39b-31f40fd2562d", "name": "response", "originalRequest": { "method": "POST", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id/resend_verification", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id", "resend_verification" ], "variable": [ { "key": "sender_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 },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-f348174c-015c-4c0c-b39b-31f40fd2562d" }, { "id": "4367eaa9-1fb8-4819-af0d-04b5646fe8b0", "name": "response", "originalRequest": { "method": "POST", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id/resend_verification", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id", "resend_verification" ], "variable": [ { "key": "sender_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\"\n },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-4367eaa9-1fb8-4819-af0d-04b5646fe8b0" } ], "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-eb763a30-b445-4fd7-a573-b3e24f1c3258" } ], "id": "1ad2e20c-1bb4-447b-b616-97ac53e7b46d", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-1ad2e20c-1bb4-447b-b616-97ac53e7b46d" }, { "name": "View a Sender Identity", "id": "d4a25a39-0837-4831-8ad4-c1f5ab9ff61a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "id": "5180f48f-f99b-478c-ad0f-e849733af90d", "key": "sender_id", "value": "", "description": "(Required) The ID of the sender identity that you want to retrieve." } ] }, "description": "**This endpoint allows you to retrieve a specific sender identity.**" }, "response": [ { "id": "579f6e37-294b-48ac-a7dc-268661d848d4", "name": "response", "originalRequest": { "method": "GET", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "key": "sender_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"address\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"nickname\": \"\",\n \"from\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"reply_to\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"address_2\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"id\": \"\",\n \"verified\": \"\",\n \"updated_at\": \"\",\n \"created_at\": \"\",\n \"locked\": \"\"\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-579f6e37-294b-48ac-a7dc-268661d848d4" }, { "id": "835067f2-f7c8-48b1-9bcf-177debce699e", "name": "response", "originalRequest": { "method": "GET", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "key": "sender_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\"\n },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-835067f2-f7c8-48b1-9bcf-177debce699e" } ], "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-d4a25a39-0837-4831-8ad4-c1f5ab9ff61a" }, { "name": "Update a Sender Identity", "id": "b8644cb9-dd51-446a-ac46-81a5e216bde3", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"nickname\": \"\",\n \"from\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"reply_to\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"address\": \"\",\n \"address_2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"country\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "id": "3c28e039-c7d7-4d32-b1ed-4de199b45628", "key": "sender_id", "value": "", "description": "(Required) The ID of the sender identity that you want to retrieve." } ] }, "description": "**This endpoint allows you to update a sender identity.**\n\nUpdates to `from.email` require re-verification.\n\nPartial updates are allowed, but fields that are marked as \"required\" in the POST (create) endpoint must not be nil if that field is included in the PATCH request." }, "response": [ { "id": "a6e492dc-eff4-4eb7-a5de-8fa09ea2d4ed", "name": "response", "originalRequest": { "method": "PATCH", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "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 \"nickname\": \"\",\n \"from\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"reply_to\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"address\": \"\",\n \"address_2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"country\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "key": "sender_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"address\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"nickname\": \"\",\n \"from\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"reply_to\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"address_2\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"id\": \"\",\n \"verified\": \"\",\n \"updated_at\": \"\",\n \"created_at\": \"\",\n \"locked\": \"\"\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-a6e492dc-eff4-4eb7-a5de-8fa09ea2d4ed" }, { "id": "8cce2b6a-3029-4ed0-b691-7ad349b07b41", "name": "response", "originalRequest": { "method": "PATCH", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "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 \"nickname\": \"\",\n \"from\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"reply_to\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"address\": \"\",\n \"address_2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"country\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "key": "sender_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 },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-8cce2b6a-3029-4ed0-b691-7ad349b07b41" }, { "id": "a54c37f2-5da3-4803-9495-55807f87bcea", "name": "response", "originalRequest": { "method": "PATCH", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "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 \"nickname\": \"\",\n \"from\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"reply_to\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"address\": \"\",\n \"address_2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"country\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "key": "sender_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 },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-a54c37f2-5da3-4803-9495-55807f87bcea" }, { "id": "b87d4906-e432-4eb0-8749-7f9a9696dd03", "name": "response", "originalRequest": { "method": "PATCH", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "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 \"nickname\": \"\",\n \"from\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"reply_to\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"address\": \"\",\n \"address_2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"country\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "key": "sender_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\"\n },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-b87d4906-e432-4eb0-8749-7f9a9696dd03" } ], "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-b8644cb9-dd51-446a-ac46-81a5e216bde3" }, { "name": "Delete a Sender Identity", "id": "9a0a550e-c225-42ab-9db0-cf15263dd8c3", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "id": "8df4152e-3e33-45b9-bcf7-a5004cb9d6fd", "key": "sender_id", "value": "", "description": "(Required) The ID of the sender identity that you want to retrieve." } ] }, "description": "**This endpoint allows you to delete one of your sender identities.**" }, "response": [ { "id": "bc123868-90d9-4d3b-9a7b-6f711db6824a", "name": "response", "originalRequest": { "method": "DELETE", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "key": "sender_id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-bc123868-90d9-4d3b-9a7b-6f711db6824a" }, { "id": "a203e0c7-2b15-4b43-8fdd-56089b1117b5", "name": "response", "originalRequest": { "method": "DELETE", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "key": "sender_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 },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-a203e0c7-2b15-4b43-8fdd-56089b1117b5" }, { "id": "000579dd-a1c8-4102-89d6-1158f591dfa6", "name": "response", "originalRequest": { "method": "DELETE", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/senders/:sender_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders", ":sender_id" ], "variable": [ { "key": "sender_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\"\n },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-000579dd-a1c8-4102-89d6-1158f591dfa6" } ], "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-9a0a550e-c225-42ab-9db0-cf15263dd8c3" } ], "id": "56a05afa-cb14-42db-aba5-a670dce6a77d", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-56a05afa-cb14-42db-aba5-a670dce6a77d" }, { "name": "Create a Sender Identity", "id": "0209620e-b0c2-438a-8483-3e651fbce6a1", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"address\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"nickname\": \"\",\n \"from\": {\n \"email\": true\n },\n \"reply_to\": {\n \"email\": false\n },\n \"address_2\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/senders", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders" ] }, "description": "**This endpoint allows you to create a new sender identity.**\n\nYou may create up to 100 unique sender identities." }, "response": [ { "id": "daf8d0de-3977-433a-a90c-648af3f88888", "name": "response", "originalRequest": { "method": "POST", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "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 \"address\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"nickname\": \"\",\n \"from\": {\n \"email\": true\n },\n \"reply_to\": {\n \"email\": false\n },\n \"address_2\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/senders", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"address\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"nickname\": \"\",\n \"from\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"reply_to\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"address_2\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"id\": \"\",\n \"verified\": \"\",\n \"updated_at\": \"\",\n \"created_at\": \"\",\n \"locked\": \"\"\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-daf8d0de-3977-433a-a90c-648af3f88888" }, { "id": "de0f5882-85ae-47aa-898a-9d0b128f6a45", "name": "response", "originalRequest": { "method": "POST", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "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 \"address\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"nickname\": \"\",\n \"from\": {\n \"email\": true\n },\n \"reply_to\": {\n \"email\": false\n },\n \"address_2\": \"\",\n \"state\": \"\",\n \"zip\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/senders", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders" ] } }, "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 },\n {\n \"message\": \"\",\n \"field\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-de0f5882-85ae-47aa-898a-9d0b128f6a45" } ], "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-0209620e-b0c2-438a-8483-3e651fbce6a1" }, { "name": "Get all Sender Identities", "id": "a5e967ba-0e4e-42bd-bfac-cca92db864a5", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/senders", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders" ] }, "description": "**This endpoint allows you to retrieve a list of all sender identities that have been created for your account.**" }, "response": [ { "id": "43a71eeb-80c7-4a60-95e5-6673b3f8889a", "name": "response", "originalRequest": { "method": "GET", "header": [ { "description": "The `on-behalf-of` header allows you to make API calls from a parent account on behalf of the parent's Subusers or customer accounts. You will use the parent account's API key when using this header. When making a call on behalf of a customer account, the property value should be \"account-id\" followed by the customer account's ID (e.g., `on-behalf-of: account-id `). When making a call on behalf of a Subuser, the property value should be the Subuser's username (e.g., `on-behalf-of: `). See [**On Behalf Of**](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of) for more information.", "key": "on-behalf-of", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/senders", "host": [ "{{baseUrl}}" ], "path": [ "v3", "senders" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": [\n {\n \"address\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"nickname\": \"\",\n \"from\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"reply_to\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"address_2\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"id\": \"\",\n \"verified\": \"\",\n \"updated_at\": \"\",\n \"created_at\": \"\",\n \"locked\": \"\"\n },\n {\n \"address\": \"\",\n \"city\": \"\",\n \"country\": \"\",\n \"nickname\": \"\",\n \"from\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"reply_to\": {\n \"email\": \"\",\n \"name\": \"\"\n },\n \"address_2\": \"\",\n \"state\": \"\",\n \"zip\": \"\",\n \"id\": \"\",\n \"verified\": \"\",\n \"updated_at\": \"\",\n \"created_at\": \"\",\n \"locked\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-43a71eeb-80c7-4a60-95e5-6673b3f8889a" } ], "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-a5e967ba-0e4e-42bd-bfac-cca92db864a5" } ], "id": "600457d4-083d-4fb5-bc86-ab56c0ac6caa", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-600457d4-083d-4fb5-bc86-ab56c0ac6caa" } ], "id": "3d1c42f2-0791-4fd1-84b6-9f88d57026e5", "createdAt": "2026-06-05T15:17:22.000Z", "updatedAt": "2026-06-05T15:17:22.000Z", "uid": "35240-3d1c42f2-0791-4fd1-84b6-9f88d57026e5" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.sendgrid.com" } ] }