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>"
  }
}

​
Errors

Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.
Integration capabilitiesThis endpoint is accessible from by integrations with any level of capabilities. The user object returned will adhere to the limitations of the integration’s capabilities. For more information on integration 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 2025-09-03.

Available options:
2025-09-03

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.