Skip to content
  • There are no suggestions because the search field is empty.

How does the Aspire integration work, end to end?

Setup, what syncs, sync frequency, and what's unique about Aspire.

Purpose

Aspire is Protiv's most mature integration. This article covers the full setup process, what data flows where, and the Aspire-specific features.

When To Use This

Use this when:

  • You're connecting Aspire to Protiv for the first time
  • You want to understand what's syncing
  • A manager asks why Protiv shows different data than Aspire

Setup at a Glance

  1. Generate an Aspire API key (Aspire admin only)
  2. Paste the credentials into Protiv
  3. Map your Aspire roles to Protiv roles
  4. Map your branch / division managers
  5. Wait for the first sync (15-30 minutes)
  6. Configure ProPay rules

See the existing article "How do I set up the Aspire API connection in Protiv?" for the credential setup.

What Syncs From Aspire to Protiv

The flow is one-way: Aspire → Protiv.

Sync Frequency

Aspire syncs every 20 minutes by default. If you need data faster, you can request a manual resync.

Aspire-Specific: Numbered Opportunity

Aspire uses "numbered opportunities" — opportunities tagged with a numeric identifier. Protiv reads this and uses it for ProPay matching.

If your Aspire admin uses non-numbered opportunities, contact support to confirm Protiv's setup.

Aspire-Specific: Manager Mapping

Protiv lets you map specific Aspire roles or positions to specific Protiv managers per branch + division.

To set this up:

  1. Go to Settings → Aspire Managers
  2. For each branch + division combo, pick the manager
  3. Save

When a job syncs from Aspire for that branch + division, the manager auto-assigns.

Aspire-Specific: Role Assignment

Aspire roles ≠ Protiv roles by default. You map them.

Go to Settings → Integrations → Aspire to see the role mapping table. For each Aspire role, pick the matching Protiv role.

Aspire-Specific: Hours Budget by Branch + Division

Aspire customers can configure different hours budgets per branch + division combination. This lets a maintenance division have different bonus targets than an installation division within the same branch.

Configure under Settings → ProPays → Budget Setup.

Aspire-Specific: Hourly Wage Tracking

Wages from Aspire sync to Protiv automatically. Wage changes in Aspire flow through.

If you also edit wages in Protiv directly (wage_activity), be aware that the next Aspire sync may overwrite. Decide which system is the source of truth.

What Doesn't Sync

  • ProPays (Protiv builds these on top of synced jobs)
  • Bonus pool configuration (Protiv only)
  • Statements (Protiv only)
  • Pro-Goals (Protiv only)

Common Mistakes & How To Fix Them

  • "Data takes too long to appear" Aspire's 20-minute sync is the bottleneck. For urgent updates, contact support for a manual sync.

  • "My Aspire role isn't appearing in Protiv's role mapping" Roles only appear after they sync at least once. If a role exists in Aspire but isn't in the mapping, wait one sync cycle.

  • "Wages keep flipping back to old values" Aspire is sync-pushing wages and overwriting your Protiv edits. Pick a source of truth and disable the other side's wage edits.

  • How do I set up the Aspire API connection in Protiv?
  • How often does Protiv sync with Aspire?
  • What data syncs between Protiv and Aspire?
  • How do materials and production tracking work with Aspire and Protiv?
  • Can I track hourly wage changes between Aspire and Protiv?