Self-hosted Integrations
      Back to home
      1. Gradient Support Center
      2. Vendor Integrations
      3. Self-hosted Integrations

      Custom Integrations

      Custom Integrations with the Synthesize API.

      Overview

      If you have the itch to build your integration with the Synthesize API, you have come to the right place.  You can build your own integration rapidly, with minimal effort; best of all, it's easy to use. 

      Prerequisites

      Creating a Custom Integration

      Step 1: Create Integration

      1. Login to Gradient
      2. Navigate to the Integrations page
      3. Select the Custom button
      4. Choose the type of integration you want to build, and press continue.
        1. Alerts & Billing 
        2. Alerts only
        3. Billing only
      5. Enter a custom integration name, vendor or distributor name, and confirm you have read and understood the Synthesize API Terms & Conditions. Then press Next. 

      Step 2: Authenticate, Set Status, Create Accounts and Services

      1. After viewing the API Knowledge base, click on Generate API Tokens and copy them.
      2. Make your GRADIENT-TOKEN 
      3. You will see that your status is now set to inactive. This means it is now ready to update the status and receive accounts and services. 
      4. Update the integration status to pending.
      5. Create the service for the integration.
      6. Create the account(s)
      7. Press Status on the Integration page in Synthesize to verify that the correct number of accounts and services are displaying. Press Next. 

      Step 3: Configure the Integration

      1. Map your account(s) and press Next
      2. Map your service(s) and press Next 
      3. Review and Press Finish
        1. A modal will appear to confirm that the integration setup is complete, but that usage will still need to be pushed for it to display on the Billing page. Press Ok. 
      4. The page will load to show your connected integration with no imported results. 

      Step 4: Sync Vendor Usage

      1. Use the Get Vendor call to pull the serviceId for the vendor. Copy it.
      2. Use Set Unit Count call.
        1. Paste in the serviceId, Update the accountId, and input the new unit count. Press Try It. 
        2. Repeat for any additional counts, pressing try it each time to submit the results. 

      Step 5: Reconcile

      1. Return to Gradient, Refresh your Page, and Reconcile!

        Updating a Custom Integration 

        Step 1: 

        1. Login to Gradient
        2. Navigate to the Integrations page, scroll to locate your customer integration, and select the card. 
        3. From here, you can update the service and account mapping, verify the connection status, and disconnect the integration. 

        What's Next?

        Now that you understand the basics of connecting a custom integration, create a script to process your integrations automatically. Check out our Creating Custom Integration Scripts using ChatGPT.

        Alternatively, you can work with our Synthesize SDK for PowerShell to help you build your integration.