You can build integrations with apps that use REST API, even if the connection is not already provided by Celigo integrator.io.
Before creating the connection, review your app’s API guide. It will provide the information you need, such as the kind of authentication that the app requires and its URI. Every app puts its documentation – guides and reference material – in different places. You can often find it by searching for “API guide” or “API documentation” on the company’s website.
Tip: Some companies put their documentation on third-party sites. If you can’t find the guide on their website, you can also try a web search.
1. Create the REST API connection
- Sign in to integrato.io.
- From the Tools and resources menu, select Flow Builder.
- When exporting data from this app, click into the Source application search bar.
– or –
When importing data into this app, click into the Destination application search bar.
- Select REST API from the list of connection types. (It is usually quickest to enter a few characters to start searching.)
- At the top right, click the Save and continue button.
2. Name the connection and choose its mode
Note: For on-premise mode, an agent must first be installed and configured. If the system you want to connect to is behind a firewall, the agent helps connect you without having to whitelist any IPs.
Name (required): Give your connection a name that is meaningful to your integration and that can help you identify it later in a list of connections.
Mode (required): Choose either...
- Cloud – Connect to an app on the cloud.
- On-premise – An on-premise app runs locally on the company’s servers. This mode requires an integrator.io agent:
- From the Agent dropdown, select an installed agent.
3. Describe the connection
Continuing in the Establish your REST API connection dialog, select a supported OAuth 2.0 connection.
Configure HTTP headers (optional): Click this button to pass additional parameters in the header. Configure any headers as needed for your integration, providing the names and values in the resulting editor.
Provider (required): Select an app that already has OAuth 2.0 enabled for Flow Builder. If your app is not in the list, choose another REST API authentication type. (See also Set up an HTTP connection with OAuth 2.0 authentication for integrator.io beta release.)
4. Save and authorize the connection
Click Save and authorize to try connecting and save these values. If the connection fails, double-check the provided settings, and test again.