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

# Creating the API User

> Set up dedicated API and regular user accounts with proper impersonation settings for Neo Agent

After creating the Neo API User security level, you need to create the actual API member account and optionally a regular user account for specific operations that require non-API user attribution.

<Info>
  This process involves creating an API-only member for programmatic access and optionally a regular user for operations like ticket assignments and time entries that require a standard user account.
</Info>

## Creating the API Member

<Steps>
  <Step title="Navigate to Resources/Users section">
    Go to **Admin → Organization Settings & Users → Resources/Users (HR)** to begin creating a new API member.

    <Frame>
      <img src="https://mintcdn.com/neoagent/pPKfcPCvpdnQRHXB/images/autotask/autotask-api-user-creation-1.png?fit=max&auto=format&n=pPKfcPCvpdnQRHXB&q=85&s=f73ef55a6e232f70e7b4ac5b9cec421c" alt="Navigate to Resources/Users (HR) section in Autotask" width="2810" height="1408" data-path="images/autotask/autotask-api-user-creation-1.png" />
    </Frame>
  </Step>

  <Step title="Initiate API member creation">
    Click to add a new resource and select the option to create an API-only member (not a regular user).

    <Frame>
      <img src="https://mintcdn.com/neoagent/pPKfcPCvpdnQRHXB/images/autotask/autotask-api-user-creation-2.png?fit=max&auto=format&n=pPKfcPCvpdnQRHXB&q=85&s=4aa34f49b729178558bd024010cd0b81" alt="Select API member option in Autotask" width="2870" height="386" data-path="images/autotask/autotask-api-user-creation-2.png" />
    </Frame>

    <Info>
      API members are specifically designed for programmatic access and have different capabilities than regular user accounts.
    </Info>
  </Step>

  <Step title="Configure basic API member details">
    Fill in the required information for the API member and assign the **Neo API User** security level you created in the previous step.

    <Frame>
      <img src="https://mintcdn.com/neoagent/pPKfcPCvpdnQRHXB/images/autotask/autotask-api-user-basic-details.png?fit=max&auto=format&n=pPKfcPCvpdnQRHXB&q=85&s=a1439bd87cd2333fc93d114c54dc15f7" alt="Configure API member basic information and security level" width="1706" height="874" data-path="images/autotask/autotask-api-user-basic-details.png" />
    </Frame>

    **Required Information:**

    * **First Name**: Neo
    * **Last Name**: API
    * **Email**: Use a dedicated email address for this API account
    * **Security Level**: Select the **Neo API User** security level you created earlier
    * **Status**: Active

    <Check>
      Make note of the API member's numeric ID displayed after creation (e.g., `342`) as you'll need this when configuring the connection to Neo Agent.
    </Check>
  </Step>

  <Step title="Configure API tracking code">
    Set up the API Integration Code (tracking identifier) for your API member to identify requests from Neo Agent.

    <Frame>
      <img src="https://mintcdn.com/neoagent/pPKfcPCvpdnQRHXB/images/autotask/autotask-api-user-tracking-code.png?fit=max&auto=format&n=pPKfcPCvpdnQRHXB&q=85&s=76fe62ff4383f94cc926544accd4aa7a" alt="Configure API tracking code for the API member" width="1492" height="496" data-path="images/autotask/autotask-api-user-tracking-code.png" />
    </Frame>

    **API Integration Code:**

    * This tracking code identifies API requests in Autotask logs
    * Use a descriptive name like "NeoAgent" or "Neo Agent Integration"
    * This helps with auditing and monitoring API usage

    <Tip>
      The tracking code appears in Autotask's API usage reports, making it easier to monitor Neo Agent's activity and troubleshoot any issues.
    </Tip>
  </Step>

  <Step title="Generate API credentials">
    After saving the API member, generate the API credentials (username and secret) that Neo Agent will use to authenticate.

    <Frame>
      <img src="https://mintcdn.com/neoagent/pPKfcPCvpdnQRHXB/images/autotask/autotask-api-user-creds.png?fit=max&auto=format&n=pPKfcPCvpdnQRHXB&q=85&s=4bb640a88738f27ee9086966059ba7a5" alt="Generate API username and secret credentials" width="1516" height="314" data-path="images/autotask/autotask-api-user-creds.png" />
    </Frame>

    **Important Credentials:**

    * **API Username**: Generated automatically by Autotask
    * **API Secret**: One-time display secret key
    * **Base URL**: Your Autotask API endpoint

    <Warning>
      Store these credentials securely. The API secret will only be displayed once and cannot be retrieved later. If you lose it, you'll need to regenerate new credentials.
    </Warning>
  </Step>
</Steps>

## Creating a Regular User (Optional)

Autotask does not allow API-only users to be assigned to tickets or create time entries directly. If you need Neo Agent to perform these operations, create a regular (non-API) user account.

<Steps>
  <Step title="Create a regular user account">
    Create a new regular user (not an API member) with a dedicated name like "Neo Agent" or similar.

    <Frame>
      <img src="https://mintcdn.com/neoagent/K0PraBkdH10Olmss/images/autotask/integration-4.png?fit=max&auto=format&n=K0PraBkdH10Olmss&q=85&s=6a01679699e37edafdc4217855e61673" alt="Create regular user for ticket assignments and time entries" width="1794" height="576" data-path="images/autotask/integration-4.png" />
    </Frame>

    **Use Cases for Regular User:**

    * Being assigned to tickets (triggers email notifications to customers)
    * Creating time entries
    * Operations that require a standard user account in Autotask
  </Step>

  <Step title="Configure regular user security level">
    Assign an appropriate security level to the regular user. This can be the same **Neo API User** security level or a different one based on your requirements.
  </Step>

  <Step title="Enable impersonation for the regular user">
    Navigate to the security level assigned to the regular user and enable impersonation:

    1. Go to **Web Services API → Resource Impersonation**
    2. Enable **Allow impersonation of resources with this security level**

    This allows the API member to impersonate this regular user when performing operations that require a non-API user context.

    <Tip>
      Enabling impersonation allows Neo Agent to perform actions as the regular user while maintaining proper audit trails showing which operations were automated.
    </Tip>
  </Step>
</Steps>

## Configuring Contact Notifications

To ensure proper communication with end users, configure how contacts are notified when tickets are updated.

<Steps>
  <Step title="Access contact notification settings">
    Navigate to contact notification configuration settings.

    <Frame>
      <img src="https://mintcdn.com/neoagent/K0PraBkdH10Olmss/images/autotask/contact-notification-1.png?fit=max&auto=format&n=K0PraBkdH10Olmss&q=85&s=2639414d4883eac6557681c93ee41ce9" alt="Access contact notification settings" width="1622" height="312" data-path="images/autotask/contact-notification-1.png" />
    </Frame>
  </Step>

  <Step title="Configure notification preferences">
    Set up notification rules for different ticket events and actions.

    <Frame>
      <img src="https://mintcdn.com/neoagent/K0PraBkdH10Olmss/images/autotask/contact-notification-2.png?fit=max&auto=format&n=K0PraBkdH10Olmss&q=85&s=046f26e1c37447a1ff23f59fa86217a1" alt="Configure notification preferences" width="1022" height="762" data-path="images/autotask/contact-notification-2.png" />
    </Frame>
  </Step>

  <Step title="Set email templates">
    Configure which email templates are used for different notification types.

    <Frame>
      <img src="https://mintcdn.com/neoagent/K0PraBkdH10Olmss/images/autotask/contact-notification-3.png?fit=max&auto=format&n=K0PraBkdH10Olmss&q=85&s=d06c3a6c8b37681a494809d8c2957de7" alt="Set email templates for notifications" width="1448" height="614" data-path="images/autotask/contact-notification-3.png" />
    </Frame>
  </Step>

  <Step title="Define notification triggers">
    Specify which actions and changes should trigger notifications to contacts.

    <Frame>
      <img src="https://mintcdn.com/neoagent/K0PraBkdH10Olmss/images/autotask/contact-notification-4.png?fit=max&auto=format&n=K0PraBkdH10Olmss&q=85&s=a4675144b4389ae22e2c33643c5387e8" alt="Define notification triggers" width="1490" height="524" data-path="images/autotask/contact-notification-4.png" />
    </Frame>
  </Step>

  <Step title="Review and save settings">
    Review all notification settings and save your configuration.

    <Frame>
      <img src="https://mintcdn.com/neoagent/K0PraBkdH10Olmss/images/autotask/contact-notification-5.png?fit=max&auto=format&n=K0PraBkdH10Olmss&q=85&s=7259ef63224de5ecbeeb2c8ada592995" alt="Review and save notification settings" width="1496" height="480" data-path="images/autotask/contact-notification-5.png" />
    </Frame>

    <Check>
      Contact notifications are now configured to ensure end users receive appropriate updates when Neo Agent performs actions on their tickets.
    </Check>
  </Step>
</Steps>

## What You've Configured

At this point, you have:

<Check>
  * Created an API member with the Neo API User security level
  * Generated API credentials for programmatic access
  * (Optional) Created a regular user account for ticket assignments and time entries
  * Configured impersonation settings to allow the API member to act as the regular user
  * Set up contact notification preferences
</Check>

## What's Next?

With your API member and optional regular user created, you're ready to [connect them to Neo Agent](/integrations/psa/autotask/connecting-to-neo) using the credentials and configuration details.

<Info>
  Before proceeding, ensure you have:

  * The numeric API member ID
  * The API username and secret
  * Your Autotask base URL
  * Your API Integration Code (tracking code)
  * (Optional) The numeric ID of the regular user for impersonation
</Info>
