Authenticate a customer on your website before displaying their account information so that you can have users manage their SendGrid account on your website completely.

Parameter Required Requirements
user Yes Customer that is registered under your account.
password Yes Password the customer submitted.
method Yes Must be set to auth. Allows you to access authentication functionality

XML Call

POST https://api.sendgrid.com/api/distributor.manage.xml
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&user=customer@example.com&password=theirsubmittedpassword&method=aut

Response: Success

1
result><message>success</message></result>

Response: Error

1
2
3
4
5
6
7
8
<?xml version="1.0" encoding="ISO-8859-1"?>

<result>
   <message>error</message>
   <errors>
      <error>... error messages ...</error>
   </errors>
</result>

JSON Call

POST https://api.sendgrid.com/api/distributor.manage.json
POST Data api_user=your_sendgrid_username&api_key=your_sendgrid_password&user=customer@example.com&password=theirsubmittedpassword&method=aut

Response: Success

1
2
3
{
  "message": "success"
}

Response: Error

1
2
3
4
5
6
{
  "message": "error",
  "errors": [
    "...error messages..."
  ]
}