Emails

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"
[
  {
    "email": "octocat@github.com",
    "verified": true,
    "primary": true,
    "visibility": "public"
  }
]

List public email addresses for a user

GET /user/public_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"
[
  {
    "email": "octocat@github.com",
    "verified": true,
    "primary": true,
    "visibility": "public"
  }
]

Add email address(es)

POST /user/emails

Input

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

[
  "octocat@github.com",
  "support@github.com"
]

Response

Status: 201 Created
[
  {
    "email": "octocat@github.com",
    "primary": false,
    "verified": false
  },
  {
    "email": "support@github.com",
    "primary": false,
    "verified": false
  }
]

Delete email address(es)

DELETE /user/emails

Input

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

[
  "octocat@github.com",
  "support@github.com"
]

Response

Status: 204 No Content

Toggle primary email visibility

PATCH /user/email/visibility

Response

Status: 200 OK
[
  {
    "email": "octocat@github.com",
    "primary": true,
    "verified": true,
    "visibility": "private"
  }
]