Skip to main content

Connections

Intellectible has a built in connections system which allows workflows to connect to 3rd party applications. Connections are authenticated accounts which can be used by workflows to perform actions on behalf of the authenticated user. They are created and managed in the connections tab on the sidebar. Use this guide to learn how to create and manage connections, create 3rd party connected apps, and troubleshoot common issues. For details on using connection nodes in your workflows, see the Connection Nodes section.

Available Connections​

Currently available connections include:

  • Gmail
  • Microsoft Outlook
  • Google Drive
  • Microsoft Sharepoint
  • Slack (custom OAuth apps see guide)

Connection Creation Process​

  • First, head to the connections tab on the sidebar. Click "Add Connection".

  • Choose from the list of connections and give the connection a name. Authenticate with the service.

  • Select your email account you wish to give access to workflows.

  • Once verifying the connection is successful, select "Manage Projects" and add the connection to the project which will contain the workflows requiring external connections.

Creating a connection:​

Connection creation

Authenticating

For Gmail accounts it is generally straightforward to authenticate a google account. Microsoft accounts may need some extra configuration to ensure a smooth setup. See the Troubleshooting Microsoft Accounts section to ensure your account is configured correctly for your organization.

Custom Slack OAuth Connections​

Intellectible now supports custom Slack app connections, allowing you to create workflows that interact with Slack using your own Slack app credentials. This gives you full control over the permissions and scopes your workflows have access to.

Creating a Slack App​

  1. Create a new Slack app

    • Go to https://api.slack.com/apps
    • Click "Create New App"
    • Select "From scratch"
    • Enter your app name and select the workspace where you want to develop the app
    • Click "Create App"

  2. Configure OAuth & Permissions

    • In the left sidebar, navigate to "OAuth & Permissions"
    • Click "Opt In" to enable refresh tokens

    Opt in for refresh tokens

  3. Add Redirect URLs

    • Still in the "OAuth & Permissions" page, scroll to the "Redirect URLs" section
    • Add the following redirect URL: https://app.intellectible.com/connection-auth
    • Click "Add" for each URL, then click "Save URLs"

  4. Add Bot Token Scopes

    • Scroll down to the "Scopes" section
    • Under "Bot Token Scopes", add the scopes your workflows will need. Common scopes include:
      • channels:read - View basic channel information
      • channels:history - View channels history
      • channels:manage - Manage public channels
      • channels:join - Join channels
      • chat:read - Read messages as the bot
      • chat:write - Send messages as the bot
      • users:read - View users in the workspace
      • users.profile:read - View user profile information
      • users:read.email - View email addresses of users
      • groups:read - View basic private channel information
      • im:read - View basic direct message information
      • im:history - View basic direct message history
      • mpim:read - View basic group direct message information
      • mpim:history - View basic group direct message history

    Add scopes and redirect URLs

    Choosing Scopes

    Only add the scopes your workflows actually need. You can always add more scopes later if required.

  5. Get your App Credentials

    • In the left sidebar, navigate to "Basic Information"
    • Scroll to the "App Credentials" section
    • You'll need:
      • Client ID
      • Client Secret (click "Show" to reveal it)
    • Keep these credentials secure - you'll need them in the next step

Adding the Custom Slack App Connection in Intellectible​

  1. Navigate to Connections

  2. Enter App Credentials

    • In the dialog box, enter:
      • Client ID - from your Slack app's Basic Information page
      • Client Secret - from your Slack app's Basic Information page
    • Give your connection a descriptive name

    Enter Slack app credentials

  3. Authenticate

    • Click Continue to Slack
    • You'll be redirected to Slack to authorize the connection
    • Select the workspace you want to connect
    • Click "Allow" to grant permissions

  4. Verify and Assign to Projects

    • Once authentication is successful, you'll see "Connection verified successfully"
    • Click "Manage Projects" to add the connection to the projects that need it
    • Your workflows can now use this Slack connection to interact with your workspace

Troubleshooting Microsoft Accounts​

Use this section if you’re having trouble connecting Microsoft accounts (e.g., SharePoint/Outlook) to Intellectible.

Before you begin​

  • Who should perform the connection: Someone authorized to approve apps for your organization (for example, a Microsoft Entra administrator such as Global Admin, Application Admin, or Cloud Application Admin). If your organization blocks user consent, an admin will need to approve once on behalf of the organization. (see the Verify Entra Authorization Level section)
  • Start from Intellectible: Always initiate the connection from within Intellectible (see the Connect section). Do not start the process in the Azure portal.

How to verify if you are an administrator in Entra​

If you are unsure whether your account can approve apps for your organization:

  1. Sign in to the Microsoft Entra admin center.
  2. Go to Microsoft Entra ID → Users → Your account → Assigned roles.
  3. Look for roles such as Global Administrator, Application Administrator, or Cloud Application Administrator.
    • If you see one of these, you can approve the Intellectible connection.
    • If not, ask your IT team or someone with one of these roles to complete the connection for you.

Connect the correct way (always use Intellectible)​

  1. In Intellectible, go to Connections → Add Connection → Microsoft.
  2. Sign in to Microsoft when prompted and review the requested access.
  3. If you’re an administrator and want to authorize for everyone in your organization, select “Consent on behalf of your organization.”
  4. Click Accept. You will be redirected back to Intellectible, and the connection will complete automatically.
Don’t use the Azure Portal button

Do not use Azure Portal → Enterprise applications → Grant admin consent for this setup. That portal flow uses a Microsoft portal redirect URL that is not part of Intellectible’s connection process and commonly causes redirect errors. Always start from Intellectible.

No problem—nothing is permanently changed. To reset:

  1. In Azure AD → Enterprise applications, open the entry for Intellectible.
  2. Go to Permissions and click Revoke admin consent (if available).
  3. (Optional) In Properties, click Delete to remove the Enterprise application entry.
  4. Return to Intellectible and repeat the Connect the correct way steps above. The entry will be recreated automatically when consent succeeds.

Common errors & quick fixes​

  • AADSTS50011 — Redirect URI mismatch
    This usually occurs when the Azure Portal’s Grant admin consent was used.
    Fix: Start consent from Intellectible (see Connect the correct way).

  • AADSTS65001 — Consent required / not granted
    Your organization blocks user consent or your account isn’t permitted to approve.
    Fix: Have an authorized administrator complete the connection from Intellectible and (if appropriate) select “Consent on behalf of your organization.”

  • AADSTS700016 — Invalid client ID
    You may be viewing the wrong Enterprise application in the portal.
    Fix: Start again from Intellectible so the correct application is used automatically.

  • invalid_grant — Code/redirect issue or code reused
    The sign-in flow wasn’t completed in one continuous step.
    Fix: Restart from Intellectible and complete the flow without refreshing or using the back button.

Verify it worked​

  • In Intellectible, a connection verification shows Connection verified successfully.
  • Use Manage Projects to add the connection to the projects that need it.
  • You can now browse or attach Microsoft resources in your workflows as applicable.

Still stuck?​

Share this with your IT/admin:

  • A screenshot of the full error and the exact time (with timezone).
  • Who attempted the connection and confirmation that it was started from Intellectible (not via the Azure Portal button).
  • Whether your organization requires an admin to approve apps or blocks user consent.