{ "info": { "_postman_id": "18fd5e9e-ebd4-4a0d-b70e-eefe88802fd9", "name": "Twilio SendGrid User API", "description": "The Twilio SendGrid User API allows you to modify the settings of a SendGrid user account such as the user's email address or username. Keeping your user profile up to date helps SendGrid verify who you are and share important communications with you.\n\nSee [**Account Details**](https://docs.sendgrid.com/ui/account-and-settings/account) for more information. You can also manage your user settings in the [SendGrid application user interface](https://app.sendgrid.com/account/details).\n\nContact Support:\n Name: Twilio SendGrid Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "lastUpdatedBy": "35240", "uid": "35240-18fd5e9e-ebd4-4a0d-b70e-eefe88802fd9" }, "item": [ { "name": "v3", "item": [ { "name": "user", "item": [ { "name": "account", "item": [ { "name": "Get a user's account information.", "id": "75ffe1b4-91c7-4f1b-9ccc-456d1f74e7c7", "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/user/account", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "account" ] }, "description": "**This endpoint allows you to retrieve your user account details.**\n\nYour user's account information includes the user's account type and reputation." }, "response": [ { "id": "596c61ed-0f6d-441b-8fff-80fb30268449", "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/user/account", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "account" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"paid\",\n \"reputation\": \"\"\n}", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-596c61ed-0f6d-441b-8fff-80fb30268449" } ], "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-75ffe1b4-91c7-4f1b-9ccc-456d1f74e7c7" } ], "id": "dc794496-055d-4652-a63e-859add12aa23", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-dc794496-055d-4652-a63e-859add12aa23" }, { "name": "credits", "item": [ { "name": "Retrieve your credit balance", "id": "e643cd17-2d8f-4183-8631-5ae6a6d9ed71", "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/user/credits", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "credits" ] }, "description": "**This endpoint allows you to retrieve the current credit balance for your account.**\n\nEach account has a credit balance, which is a base number of emails it can send before receiving per-email charges. For more information about credits and billing, see [Billing and Plan details information](https://sendgrid.com/docs/ui/account-and-settings/billing/)." }, "response": [ { "id": "3ec2c0ee-76d0-4a91-95fa-b960ef7863d6", "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/user/credits", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "credits" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"remain\": \"\",\n \"total\": \"\",\n \"overage\": \"\",\n \"used\": \"\",\n \"last_reset\": \"\",\n \"next_reset\": \"\",\n \"reset_frequency\": \"\"\n}", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-3ec2c0ee-76d0-4a91-95fa-b960ef7863d6" } ], "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-e643cd17-2d8f-4183-8631-5ae6a6d9ed71" } ], "id": "eb929553-927e-445a-b583-57445e95c23a", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-eb929553-927e-445a-b583-57445e95c23a" }, { "name": "email", "item": [ { "name": "Retrieve your account email address", "id": "7c929d52-3f93-4602-bdf0-9391825c2cc7", "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/user/email", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "email" ] }, "description": "**This endpoint allows you to retrieve the email address currently on file for your account.**" }, "response": [ { "id": "4c7f452a-7ac9-41a9-9117-870c9511475a", "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/user/email", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "email" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"email\": \"\"\n}", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-4c7f452a-7ac9-41a9-9117-870c9511475a" } ], "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-7c929d52-3f93-4602-bdf0-9391825c2cc7" }, { "name": "Update your account email address", "id": "4339e7f9-23d8-4112-a006-677bb5097017", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "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}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/user/email", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "email" ] }, "description": "**This endpoint allows you to update the email address currently on file for your account.**" }, "response": [ { "id": "95103141-0044-44ef-a547-9326f8a2499c", "name": "response", "originalRequest": { "method": "PUT", "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}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/user/email", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "email" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"email\": \"\"\n}", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-95103141-0044-44ef-a547-9326f8a2499c" } ], "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-4339e7f9-23d8-4112-a006-677bb5097017" } ], "id": "e838b7cd-24cf-4ed8-bbb7-23faa4b9f784", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-e838b7cd-24cf-4ed8-bbb7-23faa4b9f784" }, { "name": "password", "item": [ { "name": "Update your password", "id": "2f7eaab0-99fa-4f1b-8ada-31f71d4856a1", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "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 \"new_password\": \"\",\n \"old_password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/user/password", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "password" ] }, "description": "**This endpoint allows you to update your password.**" }, "response": [ { "id": "ee6d7544-28cf-4eb8-a008-78e0db851030", "name": "response", "originalRequest": { "method": "PUT", "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 \"new_password\": \"\",\n \"old_password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/user/password", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "password" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-ee6d7544-28cf-4eb8-a008-78e0db851030" } ], "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-2f7eaab0-99fa-4f1b-8ada-31f71d4856a1" } ], "id": "d3c4ac56-c64d-437b-bae6-451a06e7f6e9", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-d3c4ac56-c64d-437b-bae6-451a06e7f6e9" }, { "name": "profile", "item": [ { "name": "Get a user's profile", "id": "800079f4-0b71-4cbb-832b-d43ce6b11c2f", "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/user/profile", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "profile" ] }, "description": "**This endpoint allows you to retrieve your current profile details.**" }, "response": [ { "id": "9dd362f7-1121-4c0e-802d-007ebdb95955", "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/user/profile", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "profile" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"address\": \"\",\n \"city\": \"\",\n \"company\": \"\",\n \"country\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\",\n \"state\": \"\",\n \"website\": \"\",\n \"zip\": \"\",\n \"address2\": \"\"\n}", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-9dd362f7-1121-4c0e-802d-007ebdb95955" } ], "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-800079f4-0b71-4cbb-832b-d43ce6b11c2f" }, { "name": "Update a user's profile", "id": "c5ebb633-9ab7-47f9-8a7e-b064561ea8a4", "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 \"address\": \"\",\n \"address2\": \"\",\n \"city\": \"\",\n \"company\": \"\",\n \"country\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\",\n \"state\": \"\",\n \"website\": \"\",\n \"zip\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/user/profile", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "profile" ] }, "description": "**This endpoint allows you to update your current profile details.**\n\nAny one or more of the parameters can be updated via the PATCH `/user/profile` endpoint. You must include at least one when you PATCH." }, "response": [ { "id": "5a4e483a-0360-4aa5-a4cd-ab1d52e6b356", "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 \"address\": \"\",\n \"address2\": \"\",\n \"city\": \"\",\n \"company\": \"\",\n \"country\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\",\n \"state\": \"\",\n \"website\": \"\",\n \"zip\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/user/profile", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "profile" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"address\": \"\",\n \"address2\": \"\",\n \"city\": \"\",\n \"company\": \"\",\n \"country\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\",\n \"state\": \"\",\n \"website\": \"\",\n \"zip\": \"\"\n}", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-5a4e483a-0360-4aa5-a4cd-ab1d52e6b356" }, { "id": "53779ef7-31b5-4e5e-9f35-812377037348", "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 \"address\": \"\",\n \"address2\": \"\",\n \"city\": \"\",\n \"company\": \"\",\n \"country\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"phone\": \"\",\n \"state\": \"\",\n \"website\": \"\",\n \"zip\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/user/profile", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "profile" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-53779ef7-31b5-4e5e-9f35-812377037348" } ], "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-c5ebb633-9ab7-47f9-8a7e-b064561ea8a4" } ], "id": "a6f7cc56-f25e-41da-a622-891dd50a55e8", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-a6f7cc56-f25e-41da-a622-891dd50a55e8" }, { "name": "username", "item": [ { "name": "Retrieve your username", "id": "b28ff532-cf8d-497c-b038-e561f93dc8b3", "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/user/username", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "username" ] }, "description": "**This endpoint allows you to retrieve your current account username.**" }, "response": [ { "id": "29d76b35-ab64-47df-ab92-e0a82908afbd", "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/user/username", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "username" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"username\": \"\",\n \"user_id\": \"\"\n}", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-29d76b35-ab64-47df-ab92-e0a82908afbd" } ], "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-b28ff532-cf8d-497c-b038-e561f93dc8b3" }, { "name": "Update your username", "id": "c02a7c3e-bfcd-43ef-a8ba-7c75a9211083", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "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 \"username\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/user/username", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "username" ] }, "description": "**This endpoint allows you to update the username for your account.**" }, "response": [ { "id": "bd28b8e9-5bb0-4aa5-829c-fde091595f9d", "name": "response", "originalRequest": { "method": "PUT", "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 \"username\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/user/username", "host": [ "{{baseUrl}}" ], "path": [ "v3", "user", "username" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"username\": \"\"\n}", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-bd28b8e9-5bb0-4aa5-829c-fde091595f9d" } ], "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-c02a7c3e-bfcd-43ef-a8ba-7c75a9211083" } ], "id": "00315152-a054-422b-93d1-7b3219bfcadc", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-00315152-a054-422b-93d1-7b3219bfcadc" } ], "id": "e14514c4-77e9-404b-a2fc-414f2af7f49b", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-e14514c4-77e9-404b-a2fc-414f2af7f49b" } ], "id": "e01f179e-ab44-4cc9-abbb-e9719d1d07b4", "createdAt": "2026-06-05T15:18:14.000Z", "updatedAt": "2026-06-05T15:18:14.000Z", "uid": "35240-e01f179e-ab44-4cc9-abbb-e9719d1d07b4" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.sendgrid.com" } ] }