Retrieve your token's bot user

Retrieves the User associated with the token provided in the authorization header.

GET /v1/users/me

TypeScript SDK

JavaScript

import { Client } from "@notionhq/client"

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

const response = await notion.users.me()

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "object": "user",
  "name": "<string>",
  "avatar_url": "<string>",
  "type": "person",
  "person": {
    "email": "<string>",
    "email_verified": true
  }
}

For personal access tokens, this endpoint returns the token’s bot user. Its bot.owner.user is 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 capabilities

This endpoint works for connections with any content, property, or comment capability. User information capabilities alone don’t grant access. They only control what the owner fields in the user object show. To include the owner’s email address, the connection needs user information with email addresses. 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

200

application/json

Person

Bot

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.

Show child attributes