# Create tokens via API

Generate new API tokens on the fly via the API. Before you can do this, you must create an API token in the Cloudflare dashboard that can create subsequent tokens.

Before you can create tokens via the API, you need to generate the initial token via the Cloudflare dashboard.

Cloudflare highly recommends that you do not grant other permissions to the token when using this template. Make sure you safeguard the new token because it can create tokens with access to any of a user's resources.

Cloudflare also recommends limiting the use of the token via client IP address filtering or TTL to reduce the potential for abuse in the event that the token is compromised. Refer to Restrict token use for more information.

Once you create an API token that can create other tokens, you can now use it in the API. Refer to the API schema docs for more information.

To create a token:

- Define the policy.
- Define the restrictions.
- Create the token.

An Access Policy defines what resources the token can act on and what permissions the token has to those resources. This process is similar to how you create tokens in the Cloudflare dashboard.

Each token can contain multiple policies.

Field | Description |
---|---|

`id` | Unique read-only identifier for the policy generated after creation. |

`effect` | Defines whether this policy is allowing or denying access. If only creating one policy, use `allow` . The evaluation order for policies is as follows: 1. Explicit `DENY` Policies; 2. Explicit `ALLOW` Policies; 3. Implicit `DENY ALL` . |

`resources` | Defines what resources are allowed to be configured. |

`permission_groups` | Defines what permissions the policy grants to the included resources. |


API token policies support three resource types: `User`

, `Account`

, and `Zone`

.

Include a single account or all accounts in a token policy.

- A
**single account**is denoted as:`"com.cloudflare.api.account.<ACCOUNT_ID>": "*"`

. **All accounts**is denoted as:`"com.cloudflare.api.account.*": "*"`


Include a **single zone**, **all zones in an account**, or **all zones in all accounts** in a token policy.

- A
**single zone**is denoted as:`"com.cloudflare.api.account.zone.<ZONE_ID>": "*"`

**All Zones in an account**are denoted as:`"com.cloudflare.api.account.<ACCOUNT_ID>": {"com.cloudflare.api.account.zone.*": "*"}`

**All zones in all accounts**is denoted as:`"com.cloudflare.api.account.zone.*": "*"`


For user resources, you can only reference yourself, which is denoted as:`"com.cloudflare.api.user.<USER_TAG>": "*"`


Determine what permission groups should be applied. Refer to the full list of permission groups either in the documentation or fetch the permission groups via the API. It is only required to pass the `id`

of the permission group in the policy. Permission groups are scoped to specific resources, so a permission group in a policy will only apply to the resource type it is scoped for.

Set up any limitations on how the token can be used. API tokens allow restrictions for client IP address filtering and TTLs. Refer to Restrict token use for more information.

When defining TTLs, you can set the time at which a token becomes active with `not_before`

and the time when it expires with `expires_on`

. Both of these fields take UTC timestamps in the following format: `"2018-07-01T05:20:00Z"`

.

Limit usage of a token by client IP address filters with the following object:

Each parameter in the `in`

and `not_in`

objects must be in CIDR notation. For example, use `192.168.0.1/32`

to specify a single IP address.

Combine the previous information to create a token as in the following example: