Atera

Overview

The Atera integration lets Bumblebee workflows interact with your Atera account to manage tickets, customers, contacts, agents, alerts, and more. Use it to automate IT service operations and pull real-time data into your workflows.

Prerequisites & Setup

Before setting up the Atera integration, you need:

• An Atera account with admin access
• An API token generated from the Atera Admin panel
• API permissions scoped to the resources your workflows need

Create an API Token in Atera

1. Log in to your Atera account
2. Navigate to Admin > Data management > API
3. Click New token and configure the token name, expiration, and permissions
4. Copy the token immediately — it will not be shown again

Configure in Bumblebee

1. Go to the Integrations page in Bumblebee
2. Select Atera
3. Enter your API Token
4. Click Test Connection
5. Save the configuration

Available Tools

Contacts (4 tools)

• get_contact - Get a specific contact by ID from Atera. Required: contact_id (int).
• list_contacts - List contacts from Atera with optional filters. Optional: customer_id (int), max_records (int).
• create_contact - Create a new contact in Atera. Required: email (str). Optional: first_name (str), last_name (str), customer_id (int), job_title (str), phone (str), is_contact_person (bool).
• update_contact - Update an existing contact in Atera. Required: contact_id (int). Optional: email (str), first_name (str), last_name (str), customer_id (int), job_title (str), phone (str), is_contact_person (bool).

Customers (4 tools)

• list_customers - List customers from Atera. Optional: max_records (int).
• get_customer - Get a specific customer by ID from Atera. Required: customer_id (int).
• create_customer - Create a new customer in Atera. Required: customer_name (str). Optional: domain (str), address (str), city (str), state (str), country (str), phone (str), notes (str).
• update_customer - Update an existing customer in Atera. Required: customer_id (int). Optional: customer_name (str), domain (str), address (str), city (str), state (str), country (str), phone (str), notes (str).

Tickets (9 tools)

• create_ticket - Create a new ticket in Atera. Required: ticket_title (str), description (str). Optional: end_user_id (int), priority (str), status (str), ticket_type (str).
• list_tickets - List tickets from Atera with optional filters. Optional: customer_id (int), ticket_status (str), max_records (int).
• get_ticket - Get a specific ticket by ID from Atera. Required: ticket_id (int).
• update_ticket - Update an existing ticket in Atera. Required: ticket_id (int). Optional: ticket_title (str), status (str), ticket_type (str), priority (str), impact (str), technician_contact_id (int).
• list_tickets_by_status_modified - List tickets that have had their status recently modified. Optional: max_records (int).
• get_ticket_comments - Get comments for a specific ticket. Required: ticket_id (int).
• get_ticket_billable_duration - Get billable and non-billable time duration for a ticket. Required: ticket_id (int).
• get_ticket_work_hours_records - Get detailed work hour entries for a ticket. Required: ticket_id (int).
• list_tickets_last_modified - List tickets that have been recently modified. Optional: max_records (int).

Alerts (5 tools)

• list_alerts - List alerts from Atera with optional filters. Optional: alert_status (str), max_records (int).
• create_alert - Create a new alert in Atera. Required: device_guid (str), title (str), customer_id (int). Optional: severity (str), additional_info (str), alert_category_id (str).
• get_alert - Get a specific alert by ID from Atera. Required: alert_id (int).
• resolve_alert - Resolve an alert in Atera. Required: alert_id (int).
• delete_alert - Delete an alert from Atera. Required: alert_id (int).

Agents / Devices (4 tools)

• list_agents - List all agents/devices from Atera with optional filters. Optional: customer_id (int), max_records (int).
• get_agent - Get a specific agent/device by ID from Atera. Required: agent_id (int).
• get_installed_patches - Get installed patches for a device. Required: device_guid (str).
• get_available_patches - Get available (pending) patches for a device. Required: device_guid (str).

Contracts (3 tools)

• list_contracts - List contracts from Atera with optional customer filter. Optional: customer_id (int), max_records (int).
• get_contract - Get a specific contract by ID from Atera. Required: contract_id (int).
• list_contracts_by_customer - List contracts for a specific customer. Required: customer_id (int).