Getting Started with Custom Integrations

Syncing data using a custom integration involves five steps:

1. Creating the file
2. Formatting the data received from the application
3. Uploading the data as a JSON payload to the file you created (in step 1)
4. Retrieving the unique ID for the file with the uploaded data
5. Syncing the contents of the file into the Torii DB

🚧

Note: Requests made to the api.torii.com endpoints will require the API key created from the Torii console to be sent in the authorization header.

Once you've configured your API key, it will be saved so you can use it across different API calls.

📘

Tip

The Upload JSON with users and licenses request uses a URL returned from Get URL that is only valid for 5 minutes.

This request does not require the Torii API key because it uses a generated token with limited validity. The request also puts the file contents directly into an AWS S3 bucket.

Tools needed to build custom integrations

Custom integrations can be built with several tools:

• Google Sheets,
• LCAP / NCAP tools such as Workato, Tray.io, Make, etc.
• Completely from scratch using your preferred development language and IDE

Each request contains code samples in a variety of different languages.

📘

Tip

For multiple articles and examples of how to use these various methods, visit the Guides section of the Torii developer community.

This Quickstart guide allows you to build a custom integration without writing a single line of code using the API Explorer in less than 10 minutes.

📘

Tip-Building Custom Integrations into Google Sheets

Custom integrations can be built directly into Google Sheets.

If you currently have a lot of data stored on spreadsheets, leverage Appscript to push that data to Torii for dynamic insights and easy management.

This Guides section provides examples on how to import stagnate data in Google Sheets to Torii.

📘

Tip-Building Custom Integrations with Automation Tools

Custom integrations can also be built using automation tools such as Workato, Tray.io and Make. An example of a Workato based custom integration can be found here.

Building integrations for known SaaS applications

1. When building custom integrations for known SaaS applications, being by creating a custom integration within the integrations tab in your Torii console.
   Associate the custom integration with a known SaaS application as shown in the screenshots below:

Building custom integrations for non-SaaS, internal, or other custom applications

1. Add a Custom Application from the Settings tab in your Torii console.

2. When adding the Custom Integration from the Integrations tab, associate said integration with the custom application you created in step 1.

👍

Congratulations! At this point you should have successfully created a custom integration in Torii.

📘

Tip

For more information on how to build custom integrations visit this Quickstart Guide—Introduction to Custom Integrations