Contents

Cancel

Recommended Articles

  1. unify-apps

    Indexing

    Unify AI

    Transform raw content into searchable knowledge through AI-powered indexing and vector embeddings

  2. unify-apps

    Quentn

    Unify Integrations

    Integrate your app with Quentn to automate marketing campaigns, manage contacts, and optimize customer engagement.

  3. unify-apps

    Connector SDK

    Platform Tools

    Create custom connectors within the Unify platform to unify workflows

  4. unify-apps

    JobNimbus

    Unify Integrations

    Integrate your application with JobNimbus to manage leads, track jobs, and streamline your workflow processes efficiently

  5. unify-apps

    IMAP

    Unify Integrations

    Integrate your app with IMAP to enable seamless email synchronization, real-time access, and enhanced communication workflows.

  6. unify-apps

    Preview Your Work

    Unify Automations

    Effortlessly review & monitor your automation’s performance

  7. unify-apps

    QuickBooks

    Unify Integrations

    Integrate your app with QuickBooks to streamline accounting, automate invoicing, and manage finances effortlessly

  8. unify-apps

    FTP/FTPS

    Unify Integrations

    Connect your app with FTP/FTPS to automate secure file transfers and streamline data exchange across systems.

  9. unify-apps

    Data-Sync by Avoid Duplicate Operations Setting

    Unify Data

    Prevent infinite loops in bidirectional data synchronization by creating record hashes that ensure one-way data flow across connected systems.

  10. unify-apps

    Filters

    Unify Applications

    Enable users to refine, search, and sort data effortlessly across dashboards and datasets

  11. unify-apps

    Insided

    Unify Integrations

    Integrate your app with Insided to enhance customer engagement, streamline community management, and drive self-service support.

  12. unify-apps

    Reverse Polling

    Unify Data

    Reverse Polling technique efficiently retrieves recent data from APIs that return results in chronological order (oldest first), optimizing pagination and data processing strategies when working with time-ordered data sources.

  13. unify-apps

    Facebook Ads

    Unify Integrations

    Connect your app with Facebook Ads to automate campaign management, optimize ad performance, and track marketing success.

  14. unify-apps

    Duplicate Field

    Unify Integrations

    Create independent copies of your data fields to enable multiple mappings while preserving original values for validation and complex workflows.

  15. unify-apps

    Gainsight

    Unify Integrations

    Integrate your app with Gainsight to enhance customer success, automate engagement workflows, and drive retention

  16. unify-apps

    Simplesat

    Unify Integrations

    Integrate your app with Simplesat to collect real-time customer feedback, measure satisfaction, and improve service quality.

  17. unify-apps

    Livestorm

    Unify Integrations

    Integrate your app with Livestorm to streamline webinar hosting, automate event management, and enhance audience engagement.

  18. unify-apps

    Snowflake

    Unify Automations

    Connect to Snowflake for fast, scalable cloud data warehousing and analytics

  19. unify-apps

    Pipeline CRM

    Unify Integrations

    Integrate your app with Pipeline CRM to streamline sales processes, automate lead management, and enhance customer relationships

  20. unify-apps

    Cognito Forms

    Unify Integrations

    Integrate your app with Cognito Forms to create custom forms, automate data collection, and streamline workflows

Platform Tools
Logo
Set Up Your First Connection

Set Up Your First Connection

Logo

5 mins READ

Overview

This guide walks you through connecting your first external application or service to the Unify Apps platform using the Connection Manager. Connections are the secure links that allow your Unify Apps automations and applications to access data and perform actions in other systems like CRMs, communication tools, databases, and more. Creating connections is the foundational step for building powerful integrations.

Prerequisites

Before you start creating your first connection in Unify Apps, make sure you have the following ready:

  1. Access to your Unify Apps Account: You need to be logged into the platform.

  2. Information for the Application You Want to Connect: This is the most crucial part and varies depending on the application. You will need:

    • Knowledge of the Authentication Method: Does the application use an API Key, Basic Authentication (Username/Password, potentially an App-Specific Password), OAuth 2.0 (where you log in to the app to grant access), or another method like JWT? Check the application's developer documentation if unsure.

    • Specific Credentials:

      • The actual API Key.

      • Username and Password (or App-Specific Password if required by the service, especially if MFA is enabled).

      • OAuth 2.0 requires you to log in during the setup, but you might need details like Client ID/Secret if Unify Apps requires manual OAuth app setup for that connector.

      • Server Hostname, Port number, Database name, Domain, etc., if connecting to databases, FTP servers, or specific enterprise systems.

    • Necessary Permissions: Ensure the account or credentials you are using have the required permissions within the external application to perform the actions you intend (e.g., read contacts, post messages, update records).

Step-by-Step Guide

Follow these steps to create and configure your connection:

  1. Initiate a New Connection
    Once you are in the Connection Manager section of the Unify Apps platform, locate and click the “New Location” button to add a new connection.

    Image
    Image

    Select the Application
    You will see a list or a searchable catalog of applications and services that you can connect to. Find the application you want to connect (e.g., Slack, Salesforce, Google Sheets, MySQL). Click on the application to select it.

    Image
    Image
    Image
    Image


  2. Configure the Connection Details
    Now you'll configure the specific details for this connection instance:

    • Connection Name: Enter a unique and descriptive name for the connection in this field. This helps you identify it later (e.g., "My Production Salesforce", "Marketing Team Slack").
      Best Practice: Use a name that indicates the application and its purpose or environment (e.g., "Personal Gmail Account", "Airtable - Marketing Campaigns Base", "Shared Support IMAP Mailbox"). This is crucial if you plan multiple connections to the same type of application.

    • Authentication Type: Select the authentication method supported by the application and required for your use case from the available options (e.g., API Key, Basic Auth, OAuth 2.0). This selection must match the type of credentials you obtained from the external application.  

    • Enter Credentials/Details: Fill in the required fields based on the selected authentication type. This is where you'll use the information gathered in the Prerequisites step. Fields might include:

      • API Key

      • Username and Password

      • Host, Port, Database

      • Domain

      • Client ID, Client Secret (less common for direct user input, often handled by the OAuth flow.

      • If API Token/Key: Paste the obtained token/key value into the designated field.  

      • If Basic Authentication: Enter the Username and Password into their respective fields.  

      • If OAuth 2.0:

        • You might need to enter a Client ID and Client Secret if manually configured.  

        • More commonly, click the Authorize or Connect button.

        • A pop-up window or browser redirect will likely occur, taking you to the Google login page. Log in if prompted.

        • Grant the requested permissions (scopes) to Unify Apps.

        • Upon successful authorization, you will be redirected back to the Unify Apps connection setup screen. Ensure pop-up blockers are temporarily disabled and you authenticate correctly on the site.

      • Other Fields: Input any additional required details like Host , Port , or toggle SSL/TLS settings as needed, based on the specific connector (e.g., IMAP vs. Gmail connector) and your gathered prerequisites.  

Common Authentication Types & Key Inputs

Authentication Type

Key Inputs Typically Required in Unify Apps

General Guidance on Finding Inputs (in External App Settings)

API Key / Token

Connection Name, API Key/Token Value

Look under 'API', 'Developer Tools', 'Integrations', or 'Security' sections. Generate a new key if needed.

Bearer Token

Connection Name, Bearer Token Value

Often synonymous with API Key/Token but specifically used in Authorization: Bearer <token> headers. Found in similar locations ('API', 'Developer Tools').

Basic Authentication

Connection Name, Username, Password (or App Password)

Standard login credentials. App Password likely needed for services like Gmail/Google if MFA/2FA is enabled (generate in account security settings).

OAuth 2.0

Connection Name, (Click Authorize Button), potentially Client ID & Client Secret for specific setups

Clicking 'Authorize' usually redirects to the app's login. For setups requiring Client ID/Secret, you'd typically need to register Unify Apps as an 'OAuth App' in the external service's developer settings. Requires specifying Scopes & Callback URL.

JWT Token

Connection Name, Consumer Key (Client ID), Private Key (file upload or text), Username (of service user)

Used by services like Salesforce. Requires significant setup in the external app: creating a 'Connected App', generating a private key/certificate pair (e.g., using OpenSSL), and uploading the certificate.

No Authentication

Connection Name

Used for connecting to public APIs or resources that don't require authentication. No credentials needed.

Image
Image
Thumbnail

Note

For OAuth 2.0, instead of entering credentials directly here, you will likely see an Authorize button. Clicking this will redirect you to the application's login page in a new window or popup. Log in there to grant Unify Apps access.

Troubleshooting Common Setup Issues

If your connection test fails or you encounter errors, check these common areas:

  • Incorrect Credentials: Double-check API keys, usernames, passwords (or app-specific passwords), tokens, etc., for typos or inaccuracies. Ensure API keys haven't expired.

  • Wrong Authentication Method: Make sure you selected the authentication method that matches the credentials you have and is supported/required by the target application.

  • Incorrect Connection Details: Verify hostnames, port numbers, database names, domains, etc., are correct.

  • Insufficient Permissions/Scope: The credentials used might not have the necessary permissions within the external application (e.g., the user lacks API access, or the OAuth consent didn't grant needed scopes like read:contacts). Check permissions in the source application.

  • Network/Firewall Issues: If connecting to internal systems or databases, ensure firewalls are configured to allow connections from Unify Apps IPs (if applicable).

  • OAuth Redirect URI: If manually setting up an OAuth app in the external service, ensure the Redirect URI specified matches the one provided by Unify Apps exactly.

Next Steps

Congratulations! You have successfully set up your first connection. Now you can:

  • Use this connection when building automations in Unify Automations to interact with the connected application.

  • Leverage this connection within applications built using Unify Applications.

  • Manage this and other connections from the Connection Manager dashboard.