---
title: "Create Agent Access Token"
method: POST
path: "/api/v2/AgentAccessTokens"
tags: ["AgentAccessTokens"]
---

# Create Agent Access Token

`POST /api/v2/AgentAccessTokens`

Create a new agent access token that an agent can use to connect and send data to your FortiCNAPP instance by invoking the following endpoint:

  > `POST https://YourAccount.lacework.net/api/v2/AgentAccessTokens`

  Here is an example `body` payload:

  > `{ "tokenAlias": "prod", "tokenEnabled": "1" }`

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- AgentAccessTokensCreateSchema
  - `props` object — The access token's properties, including `createdTime` and `description`.
    - `description` string — A brief description of the token creation.
    - `os` string — The operating system.
    - `subscription` 'standard' | 'professional' | 'enterprise' — The subscription level of the token.
  - `tokenEnabled` string, required — The `tokenEnabled` property determines if an edit control is a "Text token" edit control. When the `tokenEnabled` property is set to `1`, if the user enters a separator character or a carriage return (CR), a token is automatically added and the user can continue entering values in the control.
  - `tokenAlias` string, required — The token's alias such as Ops Agent. Aliases help communicate the intended purpose of a token and are effective when a value with a single intent appears in multiple places.

## Response `201`

No Error

- object
  - `data` AgentAccessTokensResponseSchema
    - `props` object — The access token's properties, including `createdTime` and `description`.
      - `description` string — A brief description of the token creation.
      - `os` string — The operating system.
      - `subscription` 'standard' | 'professional' | 'enterprise' — The subscription level of the token.
    - `tokenEnabled` string, required — The `tokenEnabled` property determines if an edit control is a "Text token" edit control. When the `tokenEnabled` property is set to `1`, if the user enters a separator character or a carriage return (CR), a token is automatically added and the user can continue entering values in the control.
    - `tokenAlias` string, required — The token's alias such as Ops Agent. Aliases help communicate the intended purpose of a token and are effective when a value with a single intent appears in multiple places.
    - `accessToken` string — The new agent access token.
    - `createdTime` string — The time and date when the token was issued by FortiCNAPP.
    - `version` string — The FortiCNAPP Agent's version.

## Other responses

- `4XX` — Client Error
- `5XX` — Internal Server Error

---

[API](https://skmtc.net/lacework/apis/forticnapp-api-2-0-documentation.md) · [All operations](https://skmtc.net/lacework/apis/forticnapp-api-2-0-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lacework/forticnapp-api-2-0-documentation/revisions/7015f76895f2/schema)