Skip to main content

The Agreements Module

Sync agreements from your PSA or add your own, choose which count toward the Budget, and show them in Reports.

Note: Agreements syncs from ConnectWise PSA. With any other PSA, add agreements by hand. Turning on Agreements and setting up the sync needs the Administrator or Manager role. Adding and editing agreements by hand needs the Administrator, Manager, Builder or Editor role.

The Agreements module holds each client's contracts and recurring costs, whether they pay you or another vendor, so you have one list of what every client spends on an ongoing basis. Agreements can feed the client's Roadmap and Budget, and the Agreements Part puts them in their Report.
​

Turning on Agreements

An Administrator or Manager goes to Settings > System > Modules and ticks Active on Agreements. As with any module, each user's Modules setting decides who sees it: see Set Up Your Team.
​

Syncing agreements from your PSA

An Administrator or Manager turns on the sync on the Agreements tab of your PSA integration in Settings > System > Integrations, picks which agreement types to bring in, and imports them. Your PSA's integration article has the steps and the API permissions the sync needs: ConnectWise PSA Integration.
​

Agreements only come in for companies mapped on the integration's Companies tab, and they sync again every night. Administrators and Managers can click Sync at the top of the Agreements module to bring changes in now.
​

Synced agreements are read-only, apart from Include in Budget. To change anything else, change it in your PSA and it comes through on the next sync.
​

Adding an agreement by hand

  1. In the Agreements module, click Agreement.

  2. Pick the Company, and the Site if it has one. The company can't be changed later.

  3. Fill in the Name, Amount, Billing Cycle and Start Date. End Date is optional.

  4. Set the Status to Active or Inactive, and leave Include in Budget ticked if it should count toward the Budget.

  5. Click Add.

An agreement you add by hand can have a Billing Cycle of Monthly, Quarterly, Yearly, Every 2 years, Every 3 years or One-time. Edit or delete it from its row at any time.
​

Working in the Agreements module

The module lists every client's agreements, grouped by company with a total for each. Group By also groups them by type, status or billing cycle, and Manual only shows just the ones you added by hand.
​

Click an agreement to see its details. A synced agreement also shows the line items and invoice history it brought in from your PSA.
​

Agreements in the Roadmap and Budget

An agreement counts toward a client's Roadmap and Budget only when all of these are true:

  • Include in Budget is ticked. A synced agreement starts with it off, so nothing from your PSA reaches a Budget until you tick it. To tick several at once, tick their rows and use Include in Budget in the bar above the list. An agreement you add by hand starts with it ticked.

  • Its Status is Active.

  • It has a Billing Cycle. A synced agreement with a blank one never reaches the Budget.

  • The Report has the Agreements Part.

Agreements show on the Roadmap. On the Budget, a recurring agreement also needs Recurring turned on in the Budget Part's Part Settings. How Your Budget Comes Together covers the other sources and how to keep a cost from counting twice.
​

Adding the Agreements Part to your Reports

Every Report template has an Agreements Part, switched off. An Administrator, Manager or Builder turns it on:

  1. Go to Settings > Templates > Strategy, open your template and go to its Parts tab.

  2. Tick Build, Presentation and Display on the Agreements Part.

  3. Click Apply Part Settings To All Drafts, so your Open Reports get it too.

While a Report is Open, the Agreements Part shows the client's agreements as they are now. When the Report is Completed, the Part keeps them as they were at that moment, line items and invoices included, and they can't be changed. Configure the Report covers Parts and the three modes.
​

Good to know

  • A synced agreement that stops matching your sync settings, is deleted in your PSA or whose company is no longer mapped drops out of the module, the Agreements Part and the Budget. If it matches again on a later sync, it comes back with its Include in Budget setting.

  • Turning the sync off takes your synced agreements out of the module, the Agreements Part and the Budget.

  • Synced agreements can't be deleted in Strategy Overview.

  • Client users with the External Client Editor role can add, edit and delete agreements by hand for their own company, and tick Include in Budget on synced ones. Read Only and External Client Read Only users can view agreements but not change them. Billing users don't see Agreements.

Common questions

Why don't I see agreements for some of my clients?

Agreements only come in for companies mapped on your PSA integration's Companies tab, and for the agreement types, statuses and companies picked on its Agreements tab.
​

Why isn't an agreement in the client's Budget?

Check that Include in Budget is ticked, the Status is Active, the agreement has a Billing Cycle and the Report has the Agreements Part. For a recurring agreement, Recurring also needs to be on in the Budget Part's Part Settings.
​

Can I use Agreements if my PSA doesn't sync them?

Yes. Add each agreement by hand in the Agreements module. Everything else in this article works the same for agreements you add yourself.
​

Did this answer your question?