{ "info": { "_postman_id": "c74a15ae-4c58-4b66-9303-5ce692f7bd8b", "name": "Twilio SendGrid Mail Settings API", "description": "The Twilio SendGrid Mail Settings API allows you to retrieve and configure the various Mail Settings available. Mail Settings instruct SendGrid to apply specific settings to every email that you send over [SendGrid\u2019s Web API](https://docs.sendgrid.com/api-reference/mail-send/v3-mail-send) or [SMTP relay](https://sendgrid.com/docs/for-developers/sending-email/building-an-x-smtpapi-header/). These settings include how to embed a custom footer, how to manage blocks, spam, and bounces, and more.\n\nFor a full list of Twilio SendGrid's Mail Settings, and what each one does, see [**Mail Settings**](https://sendgrid.com/docs/ui/account-and-settings/mail/).\n\nYou can also manage your Mail Settings in the Twilio SendGrid application user interface.\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:23.000Z", "updatedAt": "2026-06-05T15:17:23.000Z", "lastUpdatedBy": "35240", "uid": "35240-c74a15ae-4c58-4b66-9303-5ce692f7bd8b" }, "item": [ { "name": "v3", "item": [ { "name": "mail_settings", "item": [ { "name": "address_whitelist", "item": [ { "name": "Update address whitelist mail settings", "id": "f891c65c-74f6-4288-88aa-341558ace0c3", "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 \"enabled\": \"\",\n \"list\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] }, "description": "**This endpoint allows you to update your current email address whitelist settings.**\n\nYou can select whether or not this setting should be enabled by assigning the `enabled` field a `true` or `false` value.\n\nPassing only the `enabled` field to this endpoint will not alter your current `list` of whitelist entries. However, any modifications to your `list` of entries will overwrite the entire list. For this reason, you must included all existing entries you wish to retain in your `list` in addition to any new entries you intend to add. To remove one or more `list` entries, pass a `list` with only the entries you wish to retain.\n\nYou should not add generic domains such as `gmail.com` or `yahoo.com` in your `list` because your emails will not honor recipients' unsubscribes. This may cause a legal violation of [CAN-SPAM](https://sendgrid.com/docs/glossary/can-spam/) and could damage your sending reputation.\n\nThe Address Whitelist setting allows you to specify email addresses or domains for which mail should never be suppressed.\n\nFor example, if you own the domain `example.com`, and one or more of your recipients use `email@example.com` addresses, placing `example.com` in the address whitelist setting instructs Twilio SendGrid to ignore all bounces, blocks, and unsubscribes logged for that domain. In other words, all bounces, blocks, and unsubscribes will still be sent to `example.com` as if they were sent under normal sending conditions." }, "response": [ { "id": "c1f121da-4d2e-4701-86e0-154a8e91a969", "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 \"enabled\": \"\",\n \"list\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"enabled\": \"\",\n \"list\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c1f121da-4d2e-4701-86e0-154a8e91a969" }, { "id": "30d2bdda-58c6-4096-a28e-be987f6525a0", "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 \"enabled\": \"\",\n \"list\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-30d2bdda-58c6-4096-a28e-be987f6525a0" }, { "id": "532baeba-7885-459c-acf8-9c46ce4a2cc6", "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 \"enabled\": \"\",\n \"list\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-532baeba-7885-459c-acf8-9c46ce4a2cc6" }, { "id": "337dbd24-3072-4aa1-85e6-f2ebe4046f4a", "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 \"enabled\": \"\",\n \"list\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-337dbd24-3072-4aa1-85e6-f2ebe4046f4a" }, { "id": "573627fc-8450-4b58-be8e-3d489552351c", "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 \"enabled\": \"\",\n \"list\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-573627fc-8450-4b58-be8e-3d489552351c" }, { "id": "def191d5-95b2-4d22-9d57-3529956ba0af", "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 \"enabled\": \"\",\n \"list\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-def191d5-95b2-4d22-9d57-3529956ba0af" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-f891c65c-74f6-4288-88aa-341558ace0c3" }, { "name": "Retrieve address whitelist mail settings", "id": "1eb3caf1-6295-42ba-9ac7-523aacd5caed", "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/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] }, "description": "**This endpoint allows you to retrieve your current email address whitelist settings.**\n\nThe Address Whitelist setting allows you to specify email addresses or domains for which mail should never be suppressed.\n\nFor example, if you own the domain `example.com`, and one or more of your recipients use `email@example.com` addresses, placing `example.com` in the address whitelist setting instructs Twilio SendGrid to ignore all bounces, blocks, and unsubscribes logged for that domain. In other words, all bounces, blocks, and unsubscribes will still be sent to `example.com` as if they were sent under normal sending conditions." }, "response": [ { "id": "de19eb0a-5067-466a-8fa1-a0ab2a601b7d", "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/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"enabled\": \"\",\n \"list\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-de19eb0a-5067-466a-8fa1-a0ab2a601b7d" }, { "id": "263d6b2c-b7b5-453d-96b2-479ac276ddf4", "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/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-263d6b2c-b7b5-453d-96b2-479ac276ddf4" }, { "id": "535ffd8f-b74e-4f87-be6b-2713a1046a14", "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/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-535ffd8f-b74e-4f87-be6b-2713a1046a14" }, { "id": "f8b1f13b-7361-4479-99f4-79ac8e422a27", "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/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-f8b1f13b-7361-4479-99f4-79ac8e422a27" }, { "id": "f3250a22-6392-4e64-9978-4b4312786a5a", "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/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-f3250a22-6392-4e64-9978-4b4312786a5a" }, { "id": "4101e24c-c38b-462a-be0b-f7ebb2147a55", "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/mail_settings/address_whitelist", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "address_whitelist" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-4101e24c-c38b-462a-be0b-f7ebb2147a55" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-1eb3caf1-6295-42ba-9ac7-523aacd5caed" } ], "id": "c0252b4e-a5c8-4a30-bb11-ee00bfaf59ba", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c0252b4e-a5c8-4a30-bb11-ee00bfaf59ba" }, { "name": "bounce_purge", "item": [ { "name": "Update Bounce Purge Mail Settings", "id": "f30b5245-51d1-4c04-8b5e-719e7032686d", "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 \"enabled\": \"\",\n \"soft_bounces\": \"\",\n \"hard_bounces\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] }, "description": "**This endpoint allows you to update your current Bounce Purge mail settings.**\n\nThe Bounce Purge mail metting allows you to configure the maximum age of contacts in your hard and soft bounce suppressions lists. All contacts older than their respective configured age are deleted.\n\nA hard bounce occurs when an email message has been returned to the sender because the recipient's address is invalid. A hard bounce might occur because the domain name doesn't exist or because the recipient is unknown.\n\nA soft bounce occurs when an email message reaches the recipient's mail server but is bounced back undelivered before it actually reaches the recipient. A soft bounce might occur because the recipient's inbox is full.\n\nYou can also manage this setting in the [Mail Settings section of the Twilio SendGrid App](https://app.sendgrid.com/settings/mail_settings). You can manage your bounces manually using the [Bounces API](https://docs.sendgrid.com/api-reference/bounces-api) or the [Bounces menu in the Twilio SendGrid App](https://app.sendgrid.com/suppressions/bounces)." }, "response": [ { "id": "18090560-3e77-4511-ba26-e9cd117e1414", "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 \"enabled\": \"\",\n \"soft_bounces\": \"\",\n \"hard_bounces\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"enabled\": \"\",\n \"soft_bounces\": \"\",\n \"hard_bounces\": \"\"\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-18090560-3e77-4511-ba26-e9cd117e1414" }, { "id": "d8353a7a-1432-4a41-b6aa-82317ae86c14", "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 \"enabled\": \"\",\n \"soft_bounces\": \"\",\n \"hard_bounces\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-d8353a7a-1432-4a41-b6aa-82317ae86c14" }, { "id": "12bdcb0b-1811-4369-ba8b-4de2f395413c", "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 \"enabled\": \"\",\n \"soft_bounces\": \"\",\n \"hard_bounces\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-12bdcb0b-1811-4369-ba8b-4de2f395413c" }, { "id": "f691056b-e750-4666-b2f0-ea1d2203b15a", "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 \"enabled\": \"\",\n \"soft_bounces\": \"\",\n \"hard_bounces\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-f691056b-e750-4666-b2f0-ea1d2203b15a" }, { "id": "f577d009-dce0-4862-a182-054f429cf7e1", "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 \"enabled\": \"\",\n \"soft_bounces\": \"\",\n \"hard_bounces\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-f577d009-dce0-4862-a182-054f429cf7e1" }, { "id": "b299abea-d4b0-4e8e-849a-7c921f2d32bf", "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 \"enabled\": \"\",\n \"soft_bounces\": \"\",\n \"hard_bounces\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-b299abea-d4b0-4e8e-849a-7c921f2d32bf" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-f30b5245-51d1-4c04-8b5e-719e7032686d" }, { "name": "Retrieve Bounce Purge Mail Settings", "id": "85e26432-57e4-4476-9164-5d7879850ddb", "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/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] }, "description": "**This endpoint allows you to retrieve your current Bounce Purge mail settings.**\n\nThe Bounce Purge mail setting allows you to configure the maximum age of contacts in your hard and soft bounce suppressions lists. All contacts older than their respective configured age are deleted.\n\nA hard bounce occurs when an email message has been returned to the sender because the recipient's address is invalid. A hard bounce might occur because the domain name doesn't exist or because the recipient is unknown.\n\nA soft bounce occurs when an email message reaches the recipient's mail server but is bounced back undelivered before it actually reaches the recipient. A soft bounce might occur because the recipient's inbox is full.\n\nYou can also manage this setting in the [Mail Settings section of the Twilio SendGrid App](https://app.sendgrid.com/settings/mail_settings). You can manage your bounces manually using the [Bounces API](https://docs.sendgrid.com/api-reference/bounces-api) or the [Bounces menu in the Twilio SendGrid App](https://app.sendgrid.com/suppressions/bounces)." }, "response": [ { "id": "fe9ff7c9-dc16-4881-b50d-77f277ac80f8", "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/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"enabled\": \"\",\n \"soft_bounces\": \"\",\n \"hard_bounces\": \"\"\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-fe9ff7c9-dc16-4881-b50d-77f277ac80f8" }, { "id": "41441d2e-3b02-476c-bc10-5fab09a1aedc", "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/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-41441d2e-3b02-476c-bc10-5fab09a1aedc" }, { "id": "aca13b8f-ee10-4aec-a03e-3e4047a78998", "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/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-aca13b8f-ee10-4aec-a03e-3e4047a78998" }, { "id": "03bd629f-cb3b-41d1-843a-a943bc0116fd", "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/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-03bd629f-cb3b-41d1-843a-a943bc0116fd" }, { "id": "a81fbc4d-c2bf-444b-bf30-abeb3ce7e82a", "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/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-a81fbc4d-c2bf-444b-bf30-abeb3ce7e82a" }, { "id": "46398e73-a587-4f35-9ae2-c1d8f9e25dcb", "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/mail_settings/bounce_purge", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "bounce_purge" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-46398e73-a587-4f35-9ae2-c1d8f9e25dcb" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-85e26432-57e4-4476-9164-5d7879850ddb" } ], "id": "d5dbec56-c4ea-4aae-868e-6643c44cddd6", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-d5dbec56-c4ea-4aae-868e-6643c44cddd6" }, { "name": "footer", "item": [ { "name": "Update footer mail settings", "id": "3f222c36-7253-47bd-ac8e-6b241efe0406", "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 \"enabled\": \"\",\n \"html_content\": \"\",\n \"plain_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] }, "description": "**This endpoint allows you to update your current Footer mail settings.**\n\nThe Footer setting will insert a custom footer at the bottom of your text and HTML email message bodies.\n\nYou can insert your HTML or plain text directly using this endpoint, or you can create the footer using the [Mail Settings menu in the Twilio SendGrid App](https://app.sendgrid.com/settings/mail_settings)." }, "response": [ { "id": "6b0b4867-9a92-4099-a6f5-927f466c282d", "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 \"enabled\": \"\",\n \"html_content\": \"\",\n \"plain_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"enabled\": \"\",\n \"html_content\": \"\",\n \"plain_content\": \"\"\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-6b0b4867-9a92-4099-a6f5-927f466c282d" }, { "id": "bb5cc961-0adf-40e5-89e1-88e3a3271cf4", "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 \"enabled\": \"\",\n \"html_content\": \"\",\n \"plain_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-bb5cc961-0adf-40e5-89e1-88e3a3271cf4" }, { "id": "17a699e4-65e0-4c5b-9e06-f7cee0a9b70d", "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 \"enabled\": \"\",\n \"html_content\": \"\",\n \"plain_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-17a699e4-65e0-4c5b-9e06-f7cee0a9b70d" }, { "id": "4f918686-5f30-42f5-b7f5-d13b21af1357", "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 \"enabled\": \"\",\n \"html_content\": \"\",\n \"plain_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-4f918686-5f30-42f5-b7f5-d13b21af1357" }, { "id": "2e817081-5652-4c4a-8293-55e7812ce679", "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 \"enabled\": \"\",\n \"html_content\": \"\",\n \"plain_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-2e817081-5652-4c4a-8293-55e7812ce679" }, { "id": "4ecba4ca-1a4d-4c3b-a40e-f653f6a12107", "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 \"enabled\": \"\",\n \"html_content\": \"\",\n \"plain_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-4ecba4ca-1a4d-4c3b-a40e-f653f6a12107" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-3f222c36-7253-47bd-ac8e-6b241efe0406" }, { "name": "Retrieve footer mail settings", "id": "f0bdf85c-3ebc-4092-aa9d-888336de6fe1", "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/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] }, "description": "**This endpoint allows you to retrieve your current Footer mail settings.**\n\nThe Footer setting will insert a custom footer at the bottom of your text and HTML email message bodies.\n\nYou can insert your HTML or plain text directly using the \"Update footer mail settings\" endpoint, or you can create the footer using the [Mail Settings menu in the Twilio SendGrid App](https://app.sendgrid.com/settings/mail_settings)." }, "response": [ { "id": "ec841560-1fe7-4bf7-8542-02146ee9398f", "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/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"enabled\": \"\",\n \"html_content\": \"\",\n \"plain_content\": \"\"\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-ec841560-1fe7-4bf7-8542-02146ee9398f" }, { "id": "3a1d5a52-177a-4530-a7a3-289c6414b1aa", "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/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-3a1d5a52-177a-4530-a7a3-289c6414b1aa" }, { "id": "fe3eb617-a97b-4ffd-9ae2-68e7d27d8541", "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/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-fe3eb617-a97b-4ffd-9ae2-68e7d27d8541" }, { "id": "e79f17dd-9846-45dd-92cf-65bb3bcdc81e", "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/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-e79f17dd-9846-45dd-92cf-65bb3bcdc81e" }, { "id": "75f435c0-313a-4533-a428-5dea7f56ddd2", "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/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-75f435c0-313a-4533-a428-5dea7f56ddd2" }, { "id": "f297e8fa-93ec-4d0f-acfc-11f824e4cf90", "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/mail_settings/footer", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "footer" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-f297e8fa-93ec-4d0f-acfc-11f824e4cf90" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-f0bdf85c-3ebc-4092-aa9d-888336de6fe1" } ], "id": "5e104d57-51fb-4766-873e-a280d64727b9", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-5e104d57-51fb-4766-873e-a280d64727b9" }, { "name": "forward_bounce", "item": [ { "name": "Update forward bounce mail settings", "id": "ee69bc93-fec7-41c1-8eba-726570ba34a5", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] }, "description": "**This endpoint allows you to update your current bounce forwarding mail settings.**\n\nEnabling the Forward Bounce setting allows you to specify an `email` address to which bounce reports will be forwarded.\n\nYou can also configure the Forward Spam mail settings in the [Mail Settings section of the Twilio SendGrid App](https://app.sendgrid.com/settings/mail_settings)." }, "response": [ { "id": "e95e2c33-6262-41f1-838a-a0cfca4f0672", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"email\": \"\",\n \"enabled\": \"\"\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-e95e2c33-6262-41f1-838a-a0cfca4f0672" }, { "id": "a5ff703b-f728-4164-866c-7fc46210a794", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-a5ff703b-f728-4164-866c-7fc46210a794" }, { "id": "0d6dc9a6-7e2b-4c0f-85ab-4fae3948f338", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-0d6dc9a6-7e2b-4c0f-85ab-4fae3948f338" }, { "id": "16f97063-64cc-429f-a7fb-3e7f8ec52823", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-16f97063-64cc-429f-a7fb-3e7f8ec52823" }, { "id": "02bf7ad8-eaaf-42c5-8a1b-58d9a919aa33", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-02bf7ad8-eaaf-42c5-8a1b-58d9a919aa33" }, { "id": "d43c4098-7cb7-42a7-b000-602f09dd628d", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-d43c4098-7cb7-42a7-b000-602f09dd628d" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-ee69bc93-fec7-41c1-8eba-726570ba34a5" }, { "name": "Retrieve forward bounce mail settings", "id": "c2e4ea21-c63f-47b3-806e-5500ed9ff03f", "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/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] }, "description": "**This endpoint allows you to retrieve your current bounce forwarding mail settings.**\n\nEnabling the Forward Bounce setting allows you to specify `email` addresses to which bounce reports will be forwarded. This endpoint returns the email address you have set to receive forwarded bounces and an `enabled` status indicating if the setting is active." }, "response": [ { "id": "87eb900a-b350-46b5-8460-ff12a47ea38b", "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/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"email\": \"\",\n \"enabled\": \"\"\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-87eb900a-b350-46b5-8460-ff12a47ea38b" }, { "id": "c5386057-3230-4ff7-83ef-e0a2eaddf1f2", "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/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c5386057-3230-4ff7-83ef-e0a2eaddf1f2" }, { "id": "9731db5c-c2cf-4cff-bd6d-9545404bcfc6", "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/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-9731db5c-c2cf-4cff-bd6d-9545404bcfc6" }, { "id": "a4c4fed9-12b6-4060-9c25-75203d673b86", "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/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-a4c4fed9-12b6-4060-9c25-75203d673b86" }, { "id": "69527829-d743-4742-83ba-b782219350c8", "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/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-69527829-d743-4742-83ba-b782219350c8" }, { "id": "907a31be-2390-4cda-974f-12d6cdb9d25c", "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/mail_settings/forward_bounce", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_bounce" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-907a31be-2390-4cda-974f-12d6cdb9d25c" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c2e4ea21-c63f-47b3-806e-5500ed9ff03f" } ], "id": "c130f5be-71d8-4242-b7ca-b045585b8d7c", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c130f5be-71d8-4242-b7ca-b045585b8d7c" }, { "name": "forward_spam", "item": [ { "name": "Update forward spam mail settings", "id": "c5d2fa7a-2131-464d-a03e-7d9470873cac", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] }, "description": "**This endpoint allows you to update your current Forward Spam mail settings.**\n\nEnabling the Forward Spam setting allows you to specify `email` addresses to which spam reports will be forwarded. You can set multiple addresses by passing this endpoint a comma separated list of emails in a single string.\n\n```\n{\n \"email\": \"address1@example.com, address2@exapmle.com\",\n \"enabled\": true\n}\n```\n\nThe Forward Spam setting may also be used to receive emails sent to `abuse@` and `postmaster@` role addresses if you have authenticated your domain.\n\nFor example, if you authenticated `example.com` as your root domain and set a custom return path of `sub` for that domain, you could turn on Forward Spam, and any emails sent to `abuse@sub.example.com` or `postmaster@sub.example.com` would be forwarded to the email address you entered in the `email` field.\n\nYou can authenticate your domain using the \"Authenticate a domain\" endpoint or in the [Sender Authentication section of the Twilio SendGrid App](https://app.sendgrid.com/settings/sender_auth). You can also configure the Forward Spam mail settings in the [Mail Settings section of the Twilio SendGrid App](https://app.sendgrid.com/settings/mail_settings)." }, "response": [ { "id": "9427b493-aa38-486c-891d-48baa40d02e7", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"email\": \"\",\n \"enabled\": \"\"\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-9427b493-aa38-486c-891d-48baa40d02e7" }, { "id": "2cca0d67-54f4-4665-b7bf-75cff13d5c52", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-2cca0d67-54f4-4665-b7bf-75cff13d5c52" }, { "id": "711f28fd-b7d7-47a9-bca7-33db6a3c211b", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-711f28fd-b7d7-47a9-bca7-33db6a3c211b" }, { "id": "d3ef68e7-e4a2-4c92-8a38-05af9145caa1", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-d3ef68e7-e4a2-4c92-8a38-05af9145caa1" }, { "id": "1050b641-dbbc-4a4c-a7b5-94574f467594", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-1050b641-dbbc-4a4c-a7b5-94574f467594" }, { "id": "d66789ad-a0cf-4e39-8e19-a24ec9cf15f9", "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 \"email\": \"\",\n \"enabled\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-d66789ad-a0cf-4e39-8e19-a24ec9cf15f9" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c5d2fa7a-2131-464d-a03e-7d9470873cac" }, { "name": "Retrieve forward spam mail settings", "id": "0772be74-af85-4661-8381-dc969398d614", "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/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] }, "description": "**This endpoint allows you to retrieve your current Forward Spam mail settings.**\n\nEnabling the Forward Spam setting allows you to specify `email` addresses to which spam reports will be forwarded. This endpoint returns any email address(es) you have set to receive forwarded spam and an `enabled` status indicating if the setting is active." }, "response": [ { "id": "3067ec3a-0a9e-47c4-84bf-d31b749d4356", "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/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"email\": \"\",\n \"enabled\": \"\"\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-3067ec3a-0a9e-47c4-84bf-d31b749d4356" }, { "id": "c1fd8626-61c2-499f-b1de-7865f5beef74", "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/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c1fd8626-61c2-499f-b1de-7865f5beef74" }, { "id": "08bb5bd1-f4ae-4abc-8f65-1b84a3043239", "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/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-08bb5bd1-f4ae-4abc-8f65-1b84a3043239" }, { "id": "68d7a4a8-bc74-4d94-94b7-165772f82d68", "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/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-68d7a4a8-bc74-4d94-94b7-165772f82d68" }, { "id": "240007ed-603f-49c6-92e7-b08ba0e09082", "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/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-240007ed-603f-49c6-92e7-b08ba0e09082" }, { "id": "2c52366a-2598-48a7-ad05-00321f4a16b6", "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/mail_settings/forward_spam", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "forward_spam" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-2c52366a-2598-48a7-ad05-00321f4a16b6" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-0772be74-af85-4661-8381-dc969398d614" } ], "id": "cf78cbd6-cce6-41c5-9c27-cffc85b24bef", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-cf78cbd6-cce6-41c5-9c27-cffc85b24bef" }, { "name": "template", "item": [ { "name": "Update template mail settings", "id": "481853c1-b87b-4475-8ee7-75bdbe3adb78", "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 \"enabled\": \"\",\n \"html_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] }, "description": "**This endpoint allows you to update your current legacy email template settings.**\n\nThis setting refers to our original email templates. We currently support more fully featured [Dynamic Transactional Templates](https://sendgrid.com/docs/ui/sending-email/how-to-send-an-email-with-dynamic-transactional-templates/).\n\nThe legacy email template setting wraps an HTML template around your email content. This can be useful for sending out marketing email and/or other HTML formatted messages. For instructions on using legacy templates, see how to [\"Create and Edit Legacy Transactional Templates](https://sendgrid.com/docs/ui/sending-email/create-and-edit-legacy-transactional-templates/). For help migrating to our current template system, see [\"Migrating from Legacy Templates\"](https://sendgrid.com/docs/ui/sending-email/migrating-from-legacy-templates/)." }, "response": [ { "id": "b22630ee-1f46-41ea-8eea-f26c79187c2d", "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 \"enabled\": \"\",\n \"html_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"enabled\": \"\",\n \"html_content\": \"\"\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-b22630ee-1f46-41ea-8eea-f26c79187c2d" }, { "id": "e9e1ee9b-e2e2-4d73-9077-03d88b490f76", "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 \"enabled\": \"\",\n \"html_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-e9e1ee9b-e2e2-4d73-9077-03d88b490f76" }, { "id": "c2af0f4a-642c-444f-bc5d-ad6035cf9583", "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 \"enabled\": \"\",\n \"html_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c2af0f4a-642c-444f-bc5d-ad6035cf9583" }, { "id": "89a4dde1-f83a-418f-a1c4-eb17d121fa9b", "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 \"enabled\": \"\",\n \"html_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-89a4dde1-f83a-418f-a1c4-eb17d121fa9b" }, { "id": "0fbec0b5-4cc6-4970-821e-24655b2d98cd", "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 \"enabled\": \"\",\n \"html_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-0fbec0b5-4cc6-4970-821e-24655b2d98cd" }, { "id": "d7f40d51-96c7-47d7-b3ac-b5dda60d0429", "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 \"enabled\": \"\",\n \"html_content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-d7f40d51-96c7-47d7-b3ac-b5dda60d0429" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-481853c1-b87b-4475-8ee7-75bdbe3adb78" }, { "name": "Retrieve legacy template mail settings", "id": "86ad03a9-94fe-48de-bdc9-34570105a98b", "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/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] }, "description": "**This endpoint allows you to retrieve your current legacy email template settings.**\n\nThis setting refers to our original email templates. We currently support more fully featured [Dynamic Transactional Templates](https://sendgrid.com/docs/ui/sending-email/how-to-send-an-email-with-dynamic-transactional-templates/).\n\nThe legacy email template setting wraps an HTML template around your email content. This can be useful for sending out marketing email and/or other HTML formatted messages. For instructions on using legacy templates, see how to [\"Create and Edit Legacy Transactional Templates](https://sendgrid.com/docs/ui/sending-email/create-and-edit-legacy-transactional-templates/). For help migrating to our current template system, see [\"Migrating from Legacy Templates\"](https://sendgrid.com/docs/ui/sending-email/migrating-from-legacy-templates/)." }, "response": [ { "id": "c614c641-aff6-4701-a04c-64a25900f729", "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/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"enabled\": \"\",\n \"html_content\": \"\"\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c614c641-aff6-4701-a04c-64a25900f729" }, { "id": "6855a1d1-c754-45e0-be96-f6dfad673c7f", "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/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-6855a1d1-c754-45e0-be96-f6dfad673c7f" }, { "id": "f5860569-1f84-4891-bfc8-3533ce4341d6", "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/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-f5860569-1f84-4891-bfc8-3533ce4341d6" }, { "id": "59085e08-e6a9-4a25-82ef-5970dc5d54c2", "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/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-59085e08-e6a9-4a25-82ef-5970dc5d54c2" }, { "id": "c49b9433-85c9-46b1-9f04-875177fa3c88", "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/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c49b9433-85c9-46b1-9f04-875177fa3c88" }, { "id": "67242aa2-4798-4131-a759-3a8dc2427e63", "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/mail_settings/template", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings", "template" ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-67242aa2-4798-4131-a759-3a8dc2427e63" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-86ad03a9-94fe-48de-bdc9-34570105a98b" } ], "id": "603e834e-e407-4c6a-aee0-836f24476b85", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-603e834e-e407-4c6a-aee0-836f24476b85" }, { "name": "Retrieve all mail settings", "id": "03f6ba83-4ebc-4dd6-89c2-f94ed4ec3cf1", "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/mail_settings?limit=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings" ], "query": [ { "description": "`limit` sets the page size, i.e. maximum number of items from the list to be returned for a single API request. If omitted, the default page size is used.", "key": "limit", "value": "" }, { "description": "The number of items in the list to skip over before starting to retrieve the items for the requested page. The default `offset` of `0` represents the beginning of the list, i.e. the start of the first page. To request the second page of the list, set the `offset` to the page size as determined by `limit`. Use multiples of the page size as your `offset` to request further consecutive pages. E.g. assume your page size is set to `10`. An `offset` of `10` requests the second page, an `offset` of `20` requests the third page and so on, provided there are sufficiently many items in your list.", "key": "offset", "value": "0" } ] }, "description": "**This endpoint allows you to retrieve a paginated list of all mail settings.**\n\nEach setting will be returned with an `enabled` status set to `true` or `false` and a short description that explains what the setting does.\n\nYou can use the `limit` query parameter to set the page size. If your list contains more items than the page size permits, you can make multiple requests. Use the `offset` query parameter to control the position in the list from which to start retrieving additional items." }, "response": [ { "id": "74187bd4-da37-4c46-abe4-ebe5d8ef39ee", "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/mail_settings?limit=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings" ], "query": [ { "description": "`limit` sets the page size, i.e. maximum number of items from the list to be returned for a single API request. If omitted, the default page size is used.", "key": "limit", "value": "" }, { "description": "The number of items in the list to skip over before starting to retrieve the items for the requested page. The default `offset` of `0` represents the beginning of the list, i.e. the start of the first page. To request the second page of the list, set the `offset` to the page size as determined by `limit`. Use multiples of the page size as your `offset` to request further consecutive pages. E.g. assume your page size is set to `10`. An `offset` of `10` requests the second page, an `offset` of `20` requests the third page and so on, provided there are sufficiently many items in your list.", "key": "offset", "value": "0" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": [\n {\n \"title\": \"\",\n \"enabled\": \"\",\n \"name\": \"\",\n \"description\": \"\"\n },\n {\n \"title\": \"\",\n \"enabled\": \"\",\n \"name\": \"\",\n \"description\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-74187bd4-da37-4c46-abe4-ebe5d8ef39ee" }, { "id": "1eec30b8-7840-4e78-ab87-dfbddc67a461", "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/mail_settings?limit=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings" ], "query": [ { "description": "`limit` sets the page size, i.e. maximum number of items from the list to be returned for a single API request. If omitted, the default page size is used.", "key": "limit", "value": "" }, { "description": "The number of items in the list to skip over before starting to retrieve the items for the requested page. The default `offset` of `0` represents the beginning of the list, i.e. the start of the first page. To request the second page of the list, set the `offset` to the page size as determined by `limit`. Use multiples of the page size as your `offset` to request further consecutive pages. E.g. assume your page size is set to `10`. An `offset` of `10` requests the second page, an `offset` of `20` requests the third page and so on, provided there are sufficiently many items in your list.", "key": "offset", "value": "0" } ] } }, "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 \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-1eec30b8-7840-4e78-ab87-dfbddc67a461" }, { "id": "56b09ed7-f941-4025-8262-f1f050271a59", "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/mail_settings?limit=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings" ], "query": [ { "description": "`limit` sets the page size, i.e. maximum number of items from the list to be returned for a single API request. If omitted, the default page size is used.", "key": "limit", "value": "" }, { "description": "The number of items in the list to skip over before starting to retrieve the items for the requested page. The default `offset` of `0` represents the beginning of the list, i.e. the start of the first page. To request the second page of the list, set the `offset` to the page size as determined by `limit`. Use multiples of the page size as your `offset` to request further consecutive pages. E.g. assume your page size is set to `10`. An `offset` of `10` requests the second page, an `offset` of `20` requests the third page and so on, provided there are sufficiently many items in your list.", "key": "offset", "value": "0" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-56b09ed7-f941-4025-8262-f1f050271a59" }, { "id": "74fd2693-d0ce-40b3-bfd9-d00e697a1b21", "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/mail_settings?limit=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings" ], "query": [ { "description": "`limit` sets the page size, i.e. maximum number of items from the list to be returned for a single API request. If omitted, the default page size is used.", "key": "limit", "value": "" }, { "description": "The number of items in the list to skip over before starting to retrieve the items for the requested page. The default `offset` of `0` represents the beginning of the list, i.e. the start of the first page. To request the second page of the list, set the `offset` to the page size as determined by `limit`. Use multiples of the page size as your `offset` to request further consecutive pages. E.g. assume your page size is set to `10`. An `offset` of `10` requests the second page, an `offset` of `20` requests the third page and so on, provided there are sufficiently many items in your list.", "key": "offset", "value": "0" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-74fd2693-d0ce-40b3-bfd9-d00e697a1b21" }, { "id": "c197c056-d305-4ffd-b92d-44ccbc5d6e02", "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/mail_settings?limit=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings" ], "query": [ { "description": "`limit` sets the page size, i.e. maximum number of items from the list to be returned for a single API request. If omitted, the default page size is used.", "key": "limit", "value": "" }, { "description": "The number of items in the list to skip over before starting to retrieve the items for the requested page. The default `offset` of `0` represents the beginning of the list, i.e. the start of the first page. To request the second page of the list, set the `offset` to the page size as determined by `limit`. Use multiples of the page size as your `offset` to request further consecutive pages. E.g. assume your page size is set to `10`. An `offset` of `10` requests the second page, an `offset` of `20` requests the third page and so on, provided there are sufficiently many items in your list.", "key": "offset", "value": "0" } ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-c197c056-d305-4ffd-b92d-44ccbc5d6e02" }, { "id": "2a7e229f-fdbb-4124-9eb6-71d0802733de", "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/mail_settings?limit=&offset=0", "host": [ "{{baseUrl}}" ], "path": [ "v3", "mail_settings" ], "query": [ { "description": "`limit` sets the page size, i.e. maximum number of items from the list to be returned for a single API request. If omitted, the default page size is used.", "key": "limit", "value": "" }, { "description": "The number of items in the list to skip over before starting to retrieve the items for the requested page. The default `offset` of `0` represents the beginning of the list, i.e. the start of the first page. To request the second page of the list, set the `offset` to the page size as determined by `limit`. Use multiples of the page size as your `offset` to request further consecutive pages. E.g. assume your page size is set to `10`. An `offset` of `10` requests the second page, an `offset` of `20` requests the third page and so on, provided there are sufficiently many items in your list.", "key": "offset", "value": "0" } ] } }, "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 \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n },\n {\n \"message\": \"\",\n \"error_id\": \"\",\n \"field\": \"\",\n \"parameter\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-2a7e229f-fdbb-4124-9eb6-71d0802733de" } ], "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-03f6ba83-4ebc-4dd6-89c2-f94ed4ec3cf1" } ], "id": "ab8e7731-bbd0-4c00-9e85-2835f0818183", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-ab8e7731-bbd0-4c00-9e85-2835f0818183" } ], "id": "05503f70-b998-47f7-97d2-c0e54666e679", "createdAt": "2026-06-05T15:17:24.000Z", "updatedAt": "2026-06-05T15:17:24.000Z", "uid": "35240-05503f70-b998-47f7-97d2-c0e54666e679" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.sendgrid.com" } ] }