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

# Datto Autotask PSA

> Connect ThreatAware to Datto Autotask PSA to sync project and account data for enhanced asset management

## Overview

The Datto Autotask PSA integration enables ThreatAware to collect read-only data from your Datto Autotask PSA environment, providing visibility into your professional services assets and business data.

<Info>
  **Connection Method**: API
  **Setup Time**: 15 minutes
  **Access Required**: Administrator account
</Info>

## Data collected

The Datto Autotask PSA integration provides:

* Project and account information
* Ticket and issue tracking data
* Asset inventory from PSA
* Company and contact details

## Setup instructions

<Steps>
  <Step title="Log in to Datto Autotask PSA">
    Access your Datto Autotask PSA console with an administrator account that has API access permissions.
  </Step>

  <Step title="Generate API Key and Secret">
    Navigate to your Datto Autotask PSA settings to obtain API credentials:

    * Locate the **API Settings** or **Developer Settings** section
    * Generate a new **API Key**
    * Copy the **API Secret** (also called API Token)
    * Note the **Endpoint URL** (typically `https://webservices.autotask.net/ATServicesRest`)

    <Tip>
      Keep your API credentials secure. Only share them through encrypted channels.
    </Tip>
  </Step>

  <Step title="Configure in ThreatAware">
    Complete the integration setup in ThreatAware:

    * Open ThreatAware and navigate to **Settings** > **Integrations**
    * Search for and select **Datto Autotask PSA**
    * Enter the required credentials:
      * **API Key**: The API key generated in Datto Autotask PSA
      * **API Secret**: The API secret/token from your Datto account
      * **Endpoint URL**: `https://webservices.autotask.net/ATServicesRest`
    * Click **Connect** to establish the integration
  </Step>

  <Step title="Verify Connection">
    After connecting, verify the integration is working:

    * Check the **Integration Status** to confirm it shows **Active**
    * Wait for the initial data sync (typically within 1 hour)
    * Verify Datto Autotask PSA data appears in ThreatAware
  </Step>
</Steps>

## Required credentials

<AccordionGroup>
  <Accordion title="API Key" icon="key">
    **Field Name**: Datto Autotask PSA API Key
    **Type**: String
    **Description**: The API key generated in your Datto Autotask PSA account
  </Accordion>

  <Accordion title="API Secret" icon="lock">
    **Field Name**: Datto Autotask PSA API Secret
    **Type**: Password (encrypted)
    **Description**: The API secret/token associated with your API key

    <Tip>
      Store this credential securely in your organisation's password manager for future reference.
    </Tip>
  </Accordion>

  <Accordion title="Endpoint URL" icon="globe">
    **Field Name**: Datto Autotask PSA Endpoint URL
    **Type**: String
    **Description**: The API endpoint URL for your Datto Autotask PSA instance

    **Format**: `https://webservices.autotask.net/ATServicesRest`
  </Accordion>
</AccordionGroup>

## Verification and troubleshooting

<AccordionGroup>
  <Accordion title="Invalid API Credentials" icon="triangle-exclamation">
    **Symptoms**: Integration status shows authentication failure

    **Solutions**:

    * Verify the **API Key** and **API Secret** are correct
    * Ensure the API credentials were copied without extra spaces
    * Confirm the API key has not been revoked in Datto Autotask PSA
    * Check that your Datto account has API access enabled
  </Accordion>

  <Accordion title="Connection Timeout" icon="clock">
    **Symptoms**: Integration fails to connect or times out

    **Solutions**:

    * Verify the **Endpoint URL** is correct: `https://webservices.autotask.net/ATServicesRest`
    * Check firewall rules allow outbound HTTPS (443) to the Datto endpoint
    * Confirm the Datto Autotask PSA service is accessible and operational
    * Test the endpoint URL in a browser to ensure connectivity
  </Accordion>

  <Accordion title="No Data After 1 Hour" icon="database">
    **Symptoms**: Integration shows active but no PSA data appears

    **Solutions**:

    * Verify there is project and account data in Datto Autotask PSA to collect
    * Check that the API credentials have read permissions
    * Wait for the next sync cycle (typically hourly)
    * Review ThreatAware integration logs for detailed error messages
  </Accordion>
</AccordionGroup>

## Best practices

<Tip>
  **Credential Management**

  * Create a dedicated service account specifically for ThreatAware in Datto Autotask PSA
  * Document credentials securely in your organisation's password manager
  * Rotate API credentials annually or per your security policy
  * Monitor for authentication failures in ThreatAware regularly
</Tip>