Emails

• List email addresses for a user
• Add email address(es)
• Delete email address(es)

Management of email addresses via the API requires that you are authenticated through basic auth or OAuth with the user scope.

List email addresses for a user

GET /user/emails

This endpoint is accessible with the user:email scope.

Response

Status: 200 OK
Link: <https://api.github.com/resource?page=2>; rel="next",
      <https://api.github.com/resource?page=5>; rel="last"
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999

[
  {
    "email": "[email protected]",
    "verified": true,
    "primary": true
  }
]

Add email address(es)

POST /user/emails

Input

You can post a single email address or an array of addresses:

[
  "[email protected]",
  "[email protected]"
]

Response

Status: 201 Created
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999

[
  {
    "email": "[email protected]",
    "primary": false,
    "verified": false
  },
  {
    "email": "[email protected]",
    "primary": false,
    "verified": false
  }
]

Delete email address(es)

DELETE /user/emails

Input

You can include a single email address or an array of addresses:

[
  "[email protected]",
  "[email protected]"
]

Response

Status: 204 No Content
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999