Getting Started

Here’s where you’ll get the information you need to successfully start working with the Synthesize API. Need a helping feather? Contact us here.

👍

Are you a Vendor interested in using our Synthesize API?

Reach out to our Technology Alliances team.

📘

This section of the Synthesize API Documentation is Vendor Specific

If you are an MSP building a custom integration, treat this guide as if you are a vendor building an integration.

Why the Synthesize API?

Rapid to Market

The Synthesize API supports the PSAs you might already integrate with, plus many of the ones you don't. Integrating makes billing reconciliation automated for your MSP partners & resellers so they get paid for everything they do. We help you grow your channel business by connecting you to a growing list of PSAs and removing the need to spend time building, supporting, and maintaining them yourself.

Effortless to Build

Accelerate time-to-market and expand market reach through a single integration with a unified API that delivers inherited integrations to an ever-expanding list of the most popular PSAs. Building an integration using Synthesize requires 50-75% less effort than building directly with any PSA (depending on the integration use case).

Easy to Access

Access to the Synthesize is completely free for Vendors to access. No integration cost. No rev-sharing. No non-competes. No chasing anyone for API access and assistance.

First steps

As a Vendor, you will need to create and manage the services that you offer. Once complete, MSP partners will connect to your integration. Then, the Synthesize API will accept a list of their clients. Finally, the MSP will map their clients and their service offerings to yours within Synthesize.

API Modules

Billing

Billing reconciliation sucks! Synthesize Billing Module greatly increases the operational efficiency of MSPs and reduces the errors caused by manually reconciling their vendor services. Gradient helps MSPs ensure the accuracy of their invoicing without all of the manual steps that they are doing today. Make sure your partners are recognizing every bit of revenue from your products with Gradient's Synthesize Billing Module!

Check out the Billing Module for more information.

Alerts

Every MSP fights the same fight. too many tickets that aren't important are dumped into queues, and too many important notices are missed in email alert mailboxes. Gradient's Alerting Module allows vendors to push alerts directly into PSA boards as tickets. No more missed emails of mission-critical data. Gradient also allows MSPs to filter out the alerts that are not important to their business while maintaining their critical alerts. Help your partners streamline their operations with Gradient's Synthesize Alerts module!

Check out the Alerts Module for more information.

🚧

Before proceeding, please view the Use Case and User Flow Diagrams.

Prerequisites

  • JSON File - https://app.usegradient.com/api-docs-json
  • SDK - We have an SDK Available for Typescript or Powershell.
  • Vendor API Key - This is a unique key for each vendor. If you do not have an API Key, please reach out to our Technology Alliances team.
  • Partner API Key - When a partner is ready to use your integration, they will need to insert the Partner API Key. This allows us to know which Vendor and which Partner we're associating

Authorization

In order to authorize your connection with Gradient, we require a GRADIENT-TOKEN.

Visit the GRADIENT-TOKEN Generation Recipe for guidance on setting up your GRADIENT-TOKEN.

Need Assistance?

Contact Gradient Support


What’s Next

Now that you've created your GRADIENT-TOKEN, we recommend you set up your vendor services.