> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Airship with OAuth 2.0 – StackOne Hub

> Link a Airship account in the StackOne Hub using OAuth 2.0. End-user guide to authorize the integration and start using Airship actions.

> [!WARNING]
>
> Requires Owner or Administrator privileges within Airship.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Find your Airship region (EU or US)

Sign in to your Airship tenant and check your browser's URL bar to determine your region.

**1. Sign in to Airship**

Sign in to your Airship account using the appropriate host for your region.

<ul>
  <li>**US Region** — [US sign-in](https://go.urbanairship.com)</li>
  <li>**EU Region** — [EU sign-in](https://go.airship.eu)</li>
</ul>

**2. Confirm your region**

Your region is determined by the Airship domain your account is hosted on.

<ul>
  <li>`go.urbanairship.com` → **US**</li>
  <li>`go.airship.eu` → **EU**</li>
</ul>

## Retrieve your App Key

Your **App Key** identifies your Airship project and is required alongside your OAuth client credentials.

**1. Copy your App Key**

On the project's **Settings** page, copy the **App Key** shown in the **Project Details** panel.

![The Airship Settings page with the App Key value highlighted in the Project Details panel and the OAuth tile highlighted under Project configuration](https://mintcdn.com/stackone-60/W7UPHOYM7wzqkkMI/connectors/airship/images/oauth2-config-app-key.png?fit=max\&auto=format\&n=W7UPHOYM7wzqkkMI\&q=85\&s=51ef7906eb99d998c9f757ef3443dbfe)

## Create OAuth client credentials

Create client credentials in Airship to obtain a Client ID and Client Secret for the OAuth 2.0 client credentials grant.

**1. Create the credential**

On your project's **Settings** page, click **OAuth** under **Project configuration**, click **Add credentials**, then fill in the credential details on the **Define** screen.

<ul>
  <li>**Name**: `StackOne Integration`</li>
  <li>**Description**: `Integration with StackOne`</li>
  <li>**Allow Basic Auth**: turn this on. It generates a Client Secret for use in HTTP Basic Auth token requests, and this setting cannot be changed later.</li>
  <li>Click **Next**.</li>
</ul>

![The Define screen with the Name field set to StackOne Integration and the Allow Basic Auth toggle turned on](https://mintcdn.com/stackone-60/W7UPHOYM7wzqkkMI/connectors/airship/images/oauth2-config-define-credential.png?fit=max\&auto=format\&n=W7UPHOYM7wzqkkMI\&q=85\&s=1e757c5441ff0471c43e7863450bd2df)

**2. Configure permissions**

Enables actions: Create Attribute List, Create Pipeline, Create Scheduled Notification, Create Segment, Create Static List, Create Tag List, Create Template, Delete Scheduled Notification, Delete Segment, Delete Static List, Delete Tag List, Delete Template, Download Static List CSV, Get Attribute List Errors, Get Pipelines Constraints, Get Pipelines Limits, Get Schedule, Get Segment, Get Static List, Get Tag List Errors, Get Template, List Attribute Lists, List Deleted Pipelines, List Filtered Pipelines, List Pipelines, List Schedules, List Segments, List Static Lists, List Tag Lists, List Templates, Pause Schedule, Resume Schedule, Update Scheduled Notification, Update Segment, Update Static List Metadata, Update Template, Upload Attribute List CSV, Upload Static List CSV, Upload Tag List

On the **Permissions** screen, enable the permissions this integration needs:

<ul>
  <li>Click **Save**.</li>
</ul>

![The Permissions screen with the Lists, Pipelines, Push, Schedules, and Segments toggles turned on](https://mintcdn.com/stackone-60/W7UPHOYM7wzqkkMI/connectors/airship/images/oauth2-config-configure-permissions.png?fit=max\&auto=format\&n=W7UPHOYM7wzqkkMI\&q=85\&s=c6ebd0126741e2044c5c06f24c866dff)

<ul>
  <li>
    psh
  </li>

  <li>
    pln
  </li>

  <li>
    sch
  </li>

  <li>
    seg
  </li>

  <li>
    lst
  </li>
</ul>

**3. Copy your credentials**

Copy the **Client ID** and **Client Secret** across.

<ul>
  <li>The Client Secret is only displayed once and cannot be retrieved later.</li>
</ul>

![The Client Credentials screen with the Client ID visible and the Client Secret and Private Key values redacted](https://mintcdn.com/stackone-60/W7UPHOYM7wzqkkMI/connectors/airship/images/oauth2-config-credentials-created.png?fit=max\&auto=format\&n=W7UPHOYM7wzqkkMI\&q=85\&s=6818bed2565131a62813495d869f38f4)

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/connect/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.