Atera

The Atera integration automatically syncs key client data from Atera into Hudu, helping keep your documentation accurate and up to date. Companies, contacts, and devices can be imported and organized into customizable Hudu asset layouts for easy access and management. 
Before setting up your Atera integration, please read over our Understanding Integrations article to learn basic concepts and useful tips.

What You'll Need

  • Access to retrieve Atera API credentials.
  • Admin or super-admin user role within Hudu.

    At any time, you can come back to your Hudu admin area  Integrations  Atera to make changes to the integration.

Integration Features

Hudu's integration with Atera allows you to sync over:
  • Companies
    • Create client spaces within Hudu directly from Atera companies, or seamlessly merge them into existing (already-created) client spaces.
  • Contacts
    • Pull contacts directly from Atera and easily sort them into an asset layout of your choice ("People", "Contacts", "Company A employees", etc.)
  • Devices
    • Pull device information from Atera; sorted into asset layouts based on set sort rules and your default sync locations.

    You can use Connected Fields to map information from this integration into Hudu custom fields. This allows data to appear in list views and be fully searchable across your account. Learn more →

What Hudu needs from Atera

  • API Key.

Obtaining the Atera Information

  • Navigate to the Atera dashboard >> Admin.
  • Click on API.
  • Copy the API key.

1.png

1.png

Enabling the Atera Integration

  • Integrations can be enabled at any time, during Hudu environment testing or in production.
  • Once enabled, integrations can be merged into existing documentation based on predefined rules.

  • This allows you to configure the integration upfront or connect it later as needed.

  • To enable the Atera integration:

    • Navigate to the Hudu admin area (Admin → Integrations).

    • Select Atera from the list.

Setting up the Integration in Hudu

Step 1. Connect to Atera

  • Enter API Key
  • Select Default Asset Layouts

    • Choose asset layouts (must be active asset layouts) from the list to designate as the default asset layouts

    • They store information that is pulled in but not explicitly mapped to another asset layout

  • The Atera integration requires three default asset layouts for:

    • Contacts
    • Devices
    • SNMP Devices

    If you don't see/have not created any asset layouts yet, you’ll need to create these. Visit Asset layouts for additional information!

  • Select any additional options:
    • Auto-update names of Assets - If name is changed in Atera, the name will automatically be updated in Hudu
    • Do not update basic company details - This will prevent the company details from being changed in Hudu if they are changed in Atera
    • Match assets on primary serial - This option tells Atera to match devices using their primary serial number. It helps ensure that assets are correctly identified and reduces the chance of duplicates when device names or other attributes change.

 

Step 2. Test connection and run an initial sync

  • On the integration overview page, click Test Connection
  • If successful, start an initial sync to bring in Atera companies

    Make sure to test the integration for a successful connection before continuing; do not continue on until you see a connection successful message display.

 

Step 3. Match Companies

  • Before companies from Atera can be brought into Hudu, they must be matched to:

    • Existing companies in Hudu, or

    • New companies you create in Hudu

  • Hudu recommends matching one client first for testing to ensure data imports correctly

  • When the integration runs successfully for the first time:

    • Companies from Atera are imported

    • They appear in the Matched Companies List for the integration

  • Navigate to Hudu Admin → Integrations → Atera

  • Open the integration and click Match Companies

  • Review the list of companies and choose one of the following options:

    • Bulk create and/or match all companies

    • Match a company to an existing Hudu company

    • Create a new matched company in Hudu from a Atera company

    • Leave a company unmatched (it and its data will not be imported)

  • After matching companies, re-run the integration import to populate data for the matched or newly created companies
     

Step 4. Choose where data will fill

  • Add Sort Rules for Devices and SNMP Devices

    • Sort Rules determine how data types from Atera are mapped to asset layouts in Hudu

    • They let you define specific rules that control where each asset type is placed

    • Any asset types imported without an assigned Sort Rule will automatically be placed into the default asset layout

    • Asset layouts used for Sort Rules can be created ahead of time in the Hudu admin area (Admin → Asset Layouts) and must be marked as Active

    • You can also create new asset layouts directly from this section if needed.

 

FAQ

How often do integrations sync?

Answer: Native integrations will automatically re-sync (update) every 3 hours.
You can also use either the global or the card-specific re-sync features to refresh native integration syncs at any point.

Why is my integration taking a long time to finish?

Answer: If the Atera sync has been loading for a significant amount of time (it can take up to 10 minutes), follow the steps below:

  •  
    • Test the connection to ensure Hudu and Atera are communicating correctly.
    • Verify your Atera credentials.
    • Refresh the page (while a sync is actively running).
    • Stop the sync and restart the sync.
Test Connection Error: API Calls Not Supported on Atera Trial

Answer: Atera does not support API calls when using their trial version. Contact Atera support to upgrade.

Accidentally deleted an integration card, how do I get this back?

Answer: It should appear on subsequent re-syncs. If it is still not appearing, ensure that it has not been archived; and still exists in your sort rules.

Notes: Active integrations sync automatically every 3 hours; manual re-syncs can be performed either within an integrations’ settings page or by clicking the top right re-sync button.

Was this article helpful?
0 out of 0 found this helpful