GET User Profile [GET]

Retrieve your current user profile details.

Request

1
GET https://api.sendgrid.com/v3/user/profile HTTP/1.1

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
HTTP/1.1 200
{
  "address": "814 West Chapman Avenue",
  "city": "Orange",
  "company": "SendGrid",
  "country": "US",
  "first_name": "Test",
  "last_name": "User",
  "phone": "555-555-5555",
  "state": "CA",
  "website": "http://www.sendgrid.com",
  "zip": "92868"
}

PATCH User Profile [PATCH]

Update your user profile.

Request

1
PATCH https://api.sendgrid.com/v3/user/profile HTTP/1.1
Request Body
1
2
3
{
  "city": "Orange"
}

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
HTTP/1.1 200
{
  "address": "814 West Chapman Avenue",
  "city": "Orange",
  "company": "SendGrid",
  "country": "US",
  "first_name": "Test",
  "last_name": "User",
  "phone": "555-555-5555",
  "state": "CA",
  "website": "http://www.sendgrid.com",
  "zip": "92868"
}

GET User Account [GET]

Retrieve your user account details.

Request

1
GET https://api.sendgrid.com/v3/user/account HTTP/1.1

Response

1
2
3
4
5
HTTP/1.1 200
{
  "type": "free",
  "reputation": 99.7
}

GET User Email [GET]

Retrieve the email address on file for your account.

Request

1
GET https://api.sendgrid.com/v3/user/email HTTP/1.1

Response

1
2
3
4
HTTP/1.1 200
{
  "email": "test@example.com"
}

PUT User Email [PUT]

Update the email address on file for your account.

Request

1
PUT https://api.sendgrid.com/v3/user/email HTTP/1.1
Request Body
1
2
3
{
  "email": "test@example.com"
}

Response

1
2
3
4
HTTP/1.1 200
{
  "email": "test@example.com"
}

GET User Username [GET]

Retrieve your account username.

Request

1
GET https://api.sendgrid.com/v3/user/username HTTP/1.1

Response

1
2
3
4
5
HTTP/1.1 200
{
  "username": "test_username",
  "user_id": 1
}

PUT User Username [PUT]

Update your account username.

Request

1
PUT https://api.sendgrid.com/v3/user/username HTTP/1.1
Request Body
1
2
3
{
  "username": "test_username"
}

Response

1
2
3
4
HTTP/1.1 200
{
  "username": "test_username"
}

GET User Credits [GET]

Retrieve the current credit balance for your account.

Request

1
GET https://api.sendgrid.com/v3/user/credits HTTP/1.1

Response

1
2
3
4
5
6
7
8
9
10
HTTP/1.1 200
{
  "remain": 200,
  "total": 200,
  "overage": 0,
  "used": 0,
  "last_reset": "2013-01-01",
  "next_reset": "2013-02-01",
  "reset_frequency": "monthly"
}

PUT User Password [PUT]

Update the password for your account.

Request

1
PUT https://api.sendgrid.com/v3/user/password HTTP/1.1
Request Body
1
2
3
4
{
  "new_password": "new_password",
  "old_password": "old_password"
}

Response

1
2
3
HTTP/1.1 200
{
}