Integrating Airship

Capabilities

DataGrail's Airship integration provides the following capabilities:

Product	Capability
Request Manager	Request Types Access, Deletion Identifier Categories Email

Before You Start

To successfully configure this integration, please ensure you have sufficient privileges:

• DataGrail User Role: Super Admin, Connections Manager
• Airship User Role: Admin

Get Airship API Credentials

1. Log in to Airship.
2. Once logged in, examine the domain in the URL to get the Region:

Determining Region

US - domain ends with .com (e.g. https://go.airship.com)

EU - domain ends with .eu (e.g. https://go.airship.eu)

3. Navigate to the Apps page.
4. Select the application to connect.
5. Navigate to Settings.
6. Under Project Configuration, select Manage tokens.
7. Select Create Token, and enter the following configuration:

Token Configuration

Name: DataGrail

Role: All Access

8. Select Create Token.
9. Copy the Token and store it in a secure, temporary location.

Connect to DataGrail

1. In DataGrail, navigate to Integrations and select Configure New Integration to search for Airship.
2. Enter the Token and Region
3. Select your desired Asynchronous Deletion Behavior.

Airship Deletion Behavior Configuration

Mark integration as complete when a deletion request is successfully submitted: The Airship Integration will be marked as "complete" as soon as the deletion request is submitted to Airship.

Continue processing until the deletion request is completed (default behavior): The Airship Integration will show a "processing" status until the Airship deletion is complete.

4. Select Configure Integration.

Next Steps

Now that you've successfully connected the integration, check out the following resources:

• Synchronous vs. Asynchronous Integrations
• Whole Record Deletion
• Access Request Lifecycle
• Deletion Request Lifecycle

Troubleshooting

If you are unable to successfully connect the integration, review these common troubleshooting steps:

Ensure Required Permissions Are Granted on API Keys/Resources

DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.

Review Required Account Types and User Roles

If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.

See Before You Start to review these requirements.

Technical Details

The Airship integration uses the REST API v3:

Access Type	Synchronous
Deletion Type	Asynchronous (Whole Record)