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

# Aptora

> Record in Siro and track every Aptora work order's outcome.

Welcome! This guide explains what you need to do to connect your Aptora 360 account to Siro.

## What this integration enables

Once configured, the Siro–Aptora integration will:

1. **Sync your Aptora work orders to Siro** so recordings are automatically matched to the right work order, customer, job and household contacts.
2. **Sync your Aptora employees to Siro** so each work order is tied to the right rep.
3. **Write Siro data back to Aptora work orders**, such as call summaries added to the work order notes.

## How Siro tracks outcomes using Aptora

Siro uses each work order's status in Aptora to decide whether the deal tied to a recording was won or lost. These outcomes drive win rates and other outcome reporting in Siro.

| Outcome in Siro | When it applies in Aptora |
| - | - |
| **Won** | The work order is **Completed** and **invoiced** for more than \$0 |
| **Lost** | The work order is **Canceled** |
| **Open** | Anything else, including completed work orders that haven't been invoiced yet or were invoiced for \$0 |

> **Note:** A completed job counts as won only once it's invoiced. If your team invoices days after the job is done, the work order stays open in Siro until then.

## Before you begin

Before starting setup, make sure:

* You have **admin access** in both Aptora 360 and Siro.
* Your Aptora license includes **API Access**.
* Each rep's email address is the **same** in Aptora and Siro. Siro matches employees to users by email.

## Steps to connect

## Step 1: Create API credentials in Aptora

1. Log into Aptora 360 as an admin.
2. Create an API client and copy its **Client ID** and **Client Secret**. You'll need both in Step 2.
3. Go to **Company** > **User Security**. Copy security to the API client's **"(API)"** user from a user who can view and edit work orders, and view work order types, customers, employees, invoices and estimates. We recommend copying an administrator's security.

> **Important:** If the "(API)" user doesn't have these permissions, Siro can't sync or match your recordings.

## Step 2: Set up the integration in Siro

1. In the Siro web app, open **Admin** > **Integrations** in the left sidebar, then press **New Integration**.
2. Select **Aptora** from the list.
3. Enter the **Client ID** and **Client Secret** from Step 1, then save.

That's it. Work orders will start appearing in Siro shortly.

***

**Need additional assistance?** Contact your Customer Success Manager at Siro or email [support@siro.ai](mailto:support@siro.ai) and our team will help ensure you get set up properly.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.