Skip to main content
POST
Create credit access policy
The organization bot token must have the following scopes:
  • credit-limit-policy:write
Creates a named credit access policy. The policy covers no one until you create a credit access assignment for it. Policy names must be unique within a workspace. A request with a name that’s already in use returns a 400 error.

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 Admin API version to use for this request.

Available options:
2026-06-01

Path Parameters

space_id
string<uuid>
required

Body

application/json
name
string
required

Name of the policy. Names are unique within a workspace.

Required string length: 1 - 128
limit
object
required

How many Notion credits members with this policy can use.

Response

object
string
required

Always credit_access_policy

Allowed value: "credit_access_policy"
id
string<uuid>
required

ID of the policy.

space_id
string<uuid>
required

ID of the workspace the policy belongs to.

version
string
required

Changes every time the policy changes. Pass it as expected_version to update or delete the policy.

limit
object
required

How many Notion credits members with this policy can use.

name
string

Name of the policy.