Provisioning users and groups using SCIMThe SCIM API is available for workspaces in Notion’s Enterprise Plan. Learn more about using SCIM with Notion.
Setting up single sign-on (SSO) with Notion
Single sign-on (SSO) can be configured for workspaces in Notion’s Enterprise Plan. Learn more about SSO with Notion.
Where user objects appear in the API
User objects appear in nearly all objects returned by the API, including:- Block object under
created_byandlast_edited_by. - Page object under
created_byandlast_edited_byand inpeopleproperty items. - Database object under
created_byandlast_edited_by. - Rich text object, as user mentions.
- Property object when the property is a
peopleproperty.
All users
A partial user reference contains only the fields marked with *. A full user object contains every field in the table.People
User objects that represent people have thetype property set to "person". These objects also have the following properties:
Bots
A user object’stype property is "bot" when the user object represents a bot. Custom Agents appear as bots in people properties and user mentions. The user object’s id identifies the bot. A bot’s avatar_url is null when its icon isn’t an image URL. A bot user object has the following properties: