# Asana

{% stepper %}
{% step %}

### Domain

The domain of the Asana server you want to connect to. Requests will be directed to this address.

{% hint style="info" %}
Default: `app.asana.com`
{% endhint %}
{% endstep %}

{% step %}

### Personal Access Token (PAT)

Ensure you have a Personal Access Token (PAT) for Asana with sufficient permissions for the intended API calls (e.g., reading or modifying user and project data).

{% stepper %}
{% step %}

#### PAT Generation — Step 1

Go to the Asana Developer Console: <https://app.asana.com/0/my-apps>
{% endstep %}

{% step %}

#### PAT Generation — Step 2

In the **My Apps** section, scroll down to **Personal Access Tokens**.
{% endstep %}

{% step %}

#### PAT Generation — Step 3

Click **"Create new token"**.
{% endstep %}

{% step %}

#### PAT Generation — Step 4

Enter a name or description for your token (e.g. "Integration Script").
{% endstep %}

{% step %}

#### PAT Generation — Step 5

Click **"Create token"** to generate it.
{% endstep %}

{% step %}

#### PAT Generation — Step 6

You will now see your newly generated PAT. Save this token securely — once you leave the page, you won’t be able to view it again.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Ensure your PAT has sufficient permissions for the API operations you plan to perform.
{% endhint %}
{% endstep %}

{% step %}

### Workspace/Organization ID

Globally unique identifier for your workspace or organization.
{% endstep %}

{% step %}

### Proxy URL

Proxy URL. (optional)
{% endstep %}

{% step %}

### Is Secure?

Choose this if your connection is going to be over HTTPS.
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
Attention: Please perform a connection test to ensure there is a valid connection to the Asana host. When the discovery operation is finalized, you will be able to see the details on the Assets page.
{% endhint %}