Authenticate a Customer

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

1

https://sendgrid.com/api/distributor.manage.xml?api_user=username&api_key=secureSecret&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

1

https://sendgrid.com/api/distributor.manage.json?api_user=username&api_key=secureSecret&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..."
  ]
}