# API Access Management

The Pushly API uses API Tokens to allow access to the API.

API Tokens are available in the platform to **Domain Admin** users. They can be generated by navigating to the **Domain Settings** page, selecting the **Security** tab, and then clicking the **Create Token** button.

<figure><img src="https://810756845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2FjgUR4KI8zo0H1bMBhybT%2FScreenshot%202026-03-06%20at%208.29.19%E2%80%AFAM.png?alt=media&#x26;token=00346cdc-cfeb-44a1-aa03-147d8ffc613c" alt=""><figcaption></figcaption></figure>

## Creating a New API Token

From the **Security** tab, locate the **API Tokens** section and click the **Create Token** button. Enter a **Token Label** that represents the primary use of the API Token, and then click the **Create Token** button.

After clicking the **Create Token** button a new modal will appear containing the newly generated token. Click the **Copy Token** button to copy the new token to your clipboard.

> ⚠️ Ensure you save the token before closing the modal. Once the modal is closed you will not be able to view the token again.

<figure><img src="https://810756845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2F34TQ3FjyIVC9lYFzZLqr%2FScreenshot%202026-03-06%20at%208.30.23%E2%80%AFAM.png?alt=media&#x26;token=269e14d8-7579-46f9-8535-789af5fb9b1f" alt=""><figcaption></figcaption></figure>

## Revoking an Existing API Token

If an existing API Token is no longer in use or needs to be invalidated, click the **Revoke** button from the API Tokens list. On the resulting confirmation modal, click the **Revoke Token** button to invalidate the token from future use.

<figure><img src="https://810756845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lry9Z27iWOZyQEGAgY7%2Fuploads%2FDm58ZHZQAdvGNjcmkOoR%2FScreenshot%202026-03-06%20at%208.31.31%E2%80%AFAM.png?alt=media&#x26;token=9c189561-c93a-4c12-8211-1a92bc8cf084" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.pushly.com/integration-1/api-access-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
