What is a Connection

Estimated reading time: 3 min

A Connection in Wiresk is the link secure between your Wiresk Group and an external app or service. It allows Wiresk to securely access that app’s data and perform actions inside it.

For example:

  • A Gmail Connection lets Wiresk send and receive emails.
  • A HubSpot Connection lets Wiresk create, update, or find CRM records.
  • A Google Drive Connection lets Wiresk upload files or create folders.

Without a Connection, Wiresk cannot run any Trigger or Method that uses that app.

Every time your Flow interacts with an app, Wiresk needs permission to do so. That’s what the Connection provides.
It’s like logging into your app once so Wiresk can use it on your behalf.

It works like a secure login:

  • You connect your app once,
  • Wiresk stores the credentials (token or key) securely,
  • Wiresk reuses them whenever the Flow runs.

Each Connection includes:

  • Authentication (OAuth, API Key, etc.)
  • Access rights (which data or actions Wiresk can access)
  • App-specific tokens stored securely

Once a Connection is added, you can reuse it across multiple Flows within the same Group.

You can create a connection in two ways:

  1. From My Apps: Go to the My Apps section and add a new connection by selecting the app you want to connect.
  2. Within a Flow: When adding a Trigger or Method step, you can create a connection if one does not already exist.

The authentication process depends on the app. For detailed setup steps, see the Apps documentation section of the Help Center. This resource provides app-specific connection requirements. See the types of connections below.

Wiresk supports multiple types of authentication depending on the app:

OAuth Connections

  • This is the most common method.
  • You click “Connect,” log in through the app (like Gmail or Notion), and authorize Wiresk to access your account.
  • Wiresk receives a secure access token without storing your password.

OAuth Advanced (for developers)
Some platforms (e.g., HubSpot, Airtable, Power BI) offer advanced access requiring:

  • Client ID
  • Client Secret
  • Optional API scopes

To get these credentials, you may need to create a custom app in the platform’s developer portal (such as HubSpot Developer). Once the app is created, you copy the credentials into Wiresk’s Connection setup panel.

This is typically used when:

  • You’re connecting multiple user accounts under one app setup.
  • Admin-level access is required
  • Timeline events or internal-only features are needed

API Key Connections

  • Some services (like OpenAI or Mailchimp Transactional) use a personal or developer API key.
  • You enter the key manually when setting up the Connection.
  • This method is quick, but the key must be valid and have the correct permissions.

Connections are managed in the “My Apps” section of Wiresk. From this panel, you can:

  • Add a new Connection to any supported app
  • View and edit existing Connections
  • Test a Connection using the Test button to check if it is still valid and authorized
  • Disconnect or reconnect an app if the authentication expires or changes
  • Delete a Connection if it is no longer needed and not currently used in any Flow
Wiresk "My Apps" section displaying a list of connected applications. The selected app is "zoho trial account," and the right-side panel shows the configuration for the Zoho connection. The user must select the Zoho domain (defaulted to "Zoho US (Global)") and authorize access to Zoho CRM with scopes for reading, creating, updating, and deleting resources and user data. Buttons for "Test" and "Authorize" are shown at the bottom of the panel.

Let’s say you want to create a Flow that sends a confirmation email from Gmail when a new lead is added in HubSpot.

To make this work:

  1. You need a HubSpot Connection to read contact data.
  2. You need a Gmail Connection to send the email.

Both must be created first. Once connected, you can assign them to the Trigger and Method steps in the Flow.

If a Flow fails because of a Connection issue, check the following common causes:

  • Expired Token: OAuth tokens can expire. Go to My Apps > select the connection and click Authorize.
  • Changed Password or Permissions: If account access changes, update the Connection with new credentials.
  • Invalid API Key: Confirm the key is active and has the correct scopes.
  • Removed App Authorization: If Wiresk access was revoked inside the app, reauthorize it.
  • Group Restrictions: Connections are tied to Groups. If a Flow is moved, create the Connection in the new Group.
CauseSymptomFix
Expired OAuth tokenFlow fails with “Unauthorized” or login errorReconnect or reauthorize the app in My Apps
Password/permissions changeFlow stops working after account changesUpdate credentials or recreate the Connection
Invalid API keyFlow errors with “Invalid key” or access deniedEnter a valid API key with correct permissions
App authorization removedFlow cannot access the app at allReauthorize Wiresk from the app’s settings
Wrong Group assignmentFlow cannot find the needed ConnectionAdd the Connection inside the correct Group

If issues continue, check the Apps documentation or confirm with your app’s admin settings.