Automatic Login

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

Initial API Call

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

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

XML Call

1

https://sendgrid.com/api/distributor.manage.xml?api_user=username&api_key=secureSecret&method=geturl&user=customer@example.com

Response

1

params><params>al_username=username&al_subuser_name=customer@example.com&al_hash=b478ab36ebc306990dd283b1c341898e</params></params

JSON Call

1

https://sendgrid.com/api/distributor.manage.json?api_user=username&api_key=secureSecret&method=geturl&user=customer@example.com

Response

1

"params":"al_username=username&al_subuser_name=customer@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