Skip to contentSkip to navigationSkip to topbar
Twilio SendGrid Docs
On this page

Enable/disable a subuser

API Overview

api-overview page anchor

For more information about Subusers, visit the longform Subusers documentation. You can also manage Subusers in the SendGrid console(link takes you to an external page).

Operation overview

operation-overview page anchor

PATCH/v3/subusers/{subuser_name}

Base url: https://api.sendgrid.com (for global users and subusers)

Base url: https://api.eu.sendgrid.com (for EU regional subusers)

This endpoint allows you to enable or disable a subuser.

Operation details

operation-details page anchor

Authentication

authentication page anchor

Headers

headers page anchor
Property nameTypeRequiredDescription
authorizationstring
required
Default: Bearer <<YOUR_API_KEY_HERE>>

Path parameters

path-parameters page anchor
Property nameTypeRequiredDescription
subuserNamestring
required

The username of the Subuser.

Request body

request-body page anchor
Encoding type:application/json
SchemaExample
Property nameTypeRequiredDescriptionChild properties
disabledboolean

Optional

Whether or not this subuser is disabled. true means disabled, false means enabled.

Responses

responses page anchor
204400401500
No response body.
Enable/disable a subuserLink to code sample: Enable/disable a subuser
1
const client = require("@sendgrid/client");

2
client.setApiKey(process.env.SENDGRID_API_KEY);

3


4
const subuser_name = "subuser_name";

5
const data = {

6
  disabled: false,

7
};

8


9
const request = {

10
  url: `/v3/subusers/${subuser_name}`,

11
  method: "PATCH",

12
  body: data,

13
};

14


15
client

16
  .request(request)

17
  .then(([response, body]) => {

18
    console.log(response.statusCode);

19
    console.log(response.body);

20
  })

21
  .catch((error) => {

22
    console.error(error);

23
  });