Connector Commands allow you to integrate Twidget projects with external services such as Google Drive, Slack, OpenAI’s ChatGPT, and many others. These commands provide ready-made actions that communicate with third-party APIs, removing the need to manually create and maintain external HTTP requests.
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.
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.
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
You only need to authenticate once. After that, Twidget stores the credential and automatically injects it when the connector command runs.
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.
Using a connector command is similar to adding any other command:
Open an endpoint, function, or event.
Click Add Command.
Select the connector category (e.g., Google Drive, Slack, OpenAI).
Choose the specific connector command you want to run.
Provide inputs such as:
File IDs
Folder paths
Text prompts
Channel IDs
Payloads required by the external API
Select or authenticate the necessary credential.
Save your resource.
Once added, the connector command becomes part of your backend workflow and will run in sequence with your other commands.
Upload a file
List files in a folder
Get file metadata
Send a message to a channel
List user channels
Create a reminder
Generate a chat response
Create embeddings
Moderate text
Each connector includes a variety of commands tailored to that service.
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.
Date
Twidget offers a variety of commands to manipulate date objects. Below are the available commands along with their respective descriptions, inputs, and outputs. Current Date. Description: Returns the current date and time. Output: - Type: DATE Add Time. Description: Returns the date plus a specified...
Text
Twidget offers a variety of commands to manipulate text in various ways. To Uppercase. Converts all characters of the provided text to uppercase. - text: The text to be converted to uppercase. - A text string with all characters in uppercase. To Lowercase. Converts all characters of the provided tex...
Loops
In Twidget, loops allow you to execute commands multiple times, either based on a condition or through a set number of iterations. Loops can also be nested, meaning you can run loops within other loops, creating complex logic for your tasks. List Loop. The `List Loop` command enables you to loop thr...
Return
The `return` command in Twidget is a special command used to halt the current command workflow and immediately return a specified result. This command overrides any subsequent processes and outputs the return result regardless of the rest of the workflow logic. This command is particularly useful fo...
Math
Twidget offers a variety of commands to manipulate numbers. Below are the math commands available, along with their descriptions, inputs, and outputs. Sum. Description: Adds together a list of numbers and returns the sum. - Inputs: - `numbers`: A list of numbers to be added together. - Output: A sin...
