Skip to main content
GET
/
v1
/
users
/
me
TypeScript SDK
import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.users.me()
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "object": "<string>",
  "name": "<string>",
  "avatar_url": "<string>",
  "type": "<string>",
  "person": {
    "email": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.notion.com/llms.txt

Use this file to discover all available pages before exploring further.

For personal access tokens, this endpoint returns the user who created the token.

​
Errors

Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.
Connection capabilitiesThis endpoint is accessible from by connections with any level of capabilities. The user object returned will adhere to the limitations of the connection’s capabilities. For more information on connection capabilities, see the capabilities guide.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Response

​
id
string<uuid>
required

The ID of the user.

​
object
string
required

The user object type name.

Allowed value: "user"
​
name
string | null
required

The name of the user.

​
avatar_url
string | null
required

The avatar URL of the user.

​
type
string
required

Indicates this user is a person.

Allowed value: "person"
​
person
object
required

Details about the person, when the type of the user is person.