This guide explains how to activate the integration.

Note:
Before getting started, ensure you are signed in to your Upsales and Oneflow accounts with the same email.

Activate Upsales in Oneflow

The first step is activating the Upsales integration in Oneflow and generating an API token.

1. Log on to Oneflow as an administrator, go to Marketplace, click on Upsales and then on Enable.
   
2. When the Upsales integration is enabled, the Oneflow system generates an API token. You will need this to connect your Oneflow and Upsales accounts. Copy the token and securely save it for future use.

   Note:
   This API token is shown only once. If your token is missing, disable the integration and enable it again to get a new API Token.

3. Log in to Upsales > Settings and copy your Customer ID number.
   
4. Go back to the Upsales integration in Oneflow and insert the number in the Customer ID field.
   

The integration is now active in Oneflow! Now it's time to set up Upsales.

Activate Oneflow in Upsales

To set up the Oneflow integration in Upsales:

1. Log in to your Upsales account, and click your profile icon > App directory.
2. On the Apps page, scroll to Oneflow and click it.
3. In the Oneflow app window, click Activate and read through the terms message that appears.
   
4. When you've accepted the terms, you'll be redirected to the Oneflow Settings page. Insert the API key generated in Oneflow earlier.
5. Click Save.

The setup is done! Now, proceed to create a contract template in Oneflow.

Create a contract template in Oneflow

Now that all the setup is done, you need to create a contract template in Oneflow that you would like to use in Upsales. 

1. In the Oneflow application, select your Workspace and go to Templates. Click Create a template.
   
   
2. Specify the template name, add necessary fields to the template body, and save it. Then, in the template settings, go to the Template group drop-down menu and select Upsales Contract/Offer Template.
   
   
   
3. Go back to the template list and publish the template. This can also be done from the template view.
   

   Note:
   You must specify this template group separately for every contract template you'll use for creating contracts in Upsales. 

Add data fields to a contract template

Once you have your template group set, you can create data fields for the information that should be automatically pushed over from Upsales to your Oneflow contract.

To add a data field to your contract template:

1. In Oneflow, open a contract template, click the Edit icon in a form field, and click the drop-down arrow in the Data field.
   
   

2. Pick a data field and Save. Fields containing linked data from data fields show the link sign. When you create a contract using this template, this field will be pre-populated with the corresponding data field value.
   
   

   Click here to learn more about data fields and how to use them! 

Done! Time to create contracts.

Manage product data fields

When transferring charges from Upsales to product tables in Oneflow contracts, you can choose the column to which the charges are transferred to.

1. Click on your username (on the top right), then select App directory.
   

2. In the Search apps field, enter "Oneflow" and select it from the search results.
   

3. On the Settings tab, scroll to the Price column settings section.
   

4. Customize the Contract column for recurring charges and one-off charges to match your preferences and click Save.

Contract column for recurring charges

• Don't sync: Recurring charges will not be transferred to the Oneflow product table.
• Price 1: Recurring charges will be transferred to the ‘Price 1’ column of the Oneflow product table.
• Price 2: Recurring charges will be transferred to the ‘Price 2’ column of the Oneflow product table.

Contract column for one-off charges

• Don't sync: One-off charges will not be transferred to the Oneflow product table.
• Price 1: One-off charges will be transferred to the ‘Price 1’ column of the Oneflow product table.
• Price 2: One-off charges will be transferred to the ‘Price 2’ column of the Oneflow product table.