Customer Subuser Automatic Login

Allow customer subusers to manage their account from your website using an iframe to our site.

Initial API Call

In order to login your customer subuser, you need to contact our web API to retrieve the unique URL to automatically login your customer subuser. Then display the generated URL to automatically login your customer subuser.

Parameter Required Requirements Description
user Yes Must be set in email format This is the customer subuser you will attempt to automatically login
password No Your customer subuser password. Authenticate the customer subuser with this API call.

Call

1

https://sendgrid.com/apiv2/reseller.manageSubuser.xml?api_user=your_sendgrid_username&api_key=your_sendgrid_password&method=geturl&user=example@example.com

Response

1
2
3
4
5

<?xml version="1.0" encoding="ISO-8859-1"?>

<params>
   <params>al_username=username=example@example.com=b478ab36ebc306990dd283b1c341898e</params>
</params>

Call

1

https://sendgrid.com/apiv2/reseller.manageSubuser.json?api_user=your_sendgrid_username&api_key=your_sendgrid_password&method=geturl&user=example@example.com

Response

1
2
3

{
  "params": "al_username=username&al_subuser_name=example@example.com&al_hash=aa39649af578679d3a90d2cc43245d56"
}

iFrame Usage

Using the parameters returned from the Initial API Call, you can construct the iFrame URL as shown below.

1

<iframe src="https://sendgrid.com/account?al_username=username&al_subuser_name=example@example.com&al_hash=aa39649af578679d3a90d2cc43245d56"></iframe>