Connector Commands

What Are Connector Commands?

A connector is a collection of prebuilt commands designed for a specific external service.

Each connector exposes multiple actions—known as connector commands—which map directly to the service’s public API.

Examples of what connectors can do:

• Google Drive → Upload files, list folders, read documents

• Slack → Send messages, create channels, manage reminders

• OpenAI → Generate text/chat responses, perform embeddings

• Google Sheets → Append rows, read sheet values, update cells

These built-in actions allow you to interact with external platforms without having to know their API details.

Where Connector Commands Can Be Used

You can add connector commands anywhere you can run Twidget logic:

• Endpoints

• Reusable Functions

• Events (scheduled or triggered)

In these areas, a connector command behaves just like any other Twidget command, you simply insert it into the command flow and configure its inputs.

Note:

• Connector commands cannot be used inside Pages or Page Components.

• They run only on the backend.

Authentication Requirements

Most external services require authentication before their API can be used. Connector commands support this by letting you attach credentials securely.

Common methods include:

• Google OAuth – for Google Sheets, Drive, Calendar, etc.

• OpenAI API keys – for ChatGPT, embeddings, and other OpenAI models

• Slack OAuth – for reading channels, sending messages, or using the Slack API

Select an existing saved connection for the command's provider. Twidget stores its credentials privately and injects them when the server command runs. Reconnect if authorization expires, is revoked or needs different permissions; an account's status does not guarantee every provider action is allowed. Some providers need administrator setup before authorization is available. See Business connectors.

When adding a connector command you will be prompted to select:

• A previously authenticated credential

  or

• Start the authentication process for that connector

This ensures each connector action can securely interact with the external service.

How to Use a Connector Command

Using a connector command is similar to adding any other command:

1. Open an endpoint, function, or event.

2. Click Add Command.

3. Select the connector category (e.g., Google Drive, Slack, OpenAI).

4. Choose the specific connector command you want to run.

5. Provide inputs such as:

   • File IDs

   • Folder paths

   • Text prompts

   • Channel IDs

   • Payloads required by the external API

6. Select or authenticate the necessary credential.

7. Save your resource.

Once added, the connector command becomes part of your backend workflow and will run in sequence with your other commands.

Examples of Actions You Can Perform

Google Drive

• Upload a file

• List files in a folder

• Get file metadata

Slack

• Send a message to a channel

• List user channels

• Create a reminder

OpenAI

• Generate a chat response

• Create embeddings

• Generate speech or transcribe supported audio with the corresponding commands

Each connector includes a variety of commands tailored to that service.

Limitations

• Connector commands cannot be used in Pages or Page Components.

• Only supported authentication types can be used for each connector.

• The number of available commands depends on the provider’s public API.

Help without clutter

The command description appears beneath the editor title. The question-mark View documentation button opens the selected command’s full reference in the documentation sidebar.

Each field’s info button explains the expected value, units, format and relevant limits. These tooltips can be opened by keyboard or touch. Validation errors remain visible when a value needs fixing.

General guidance that applies to the command, such as supported file formats and processing limits, appears in a bordered information box above the inputs.

The reference includes exact inputs, the returned result, an illustrative example and common errors. Use its command index to switch actions without leaving your workflow.