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.
Error Handling
When building applications with Twidget, you may encounter situations where you need to handle errors gracefully to ensure your application runs smoothly. Twidget provides two powerful commands for error handling: `try-catch` and `throw-error`. This documentation will guide you on how to use these c...
Send External HTTP Request
Using Twidget, you can send external HTTP requests effortlessly. This functionality allows you to communicate with external servers or APIs. Below, you will find the necessary parameters and structure to set up an HTTP request. Parameters. - URL: The endpoint to which the request will be sent. - Met...
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...
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...
Lists
Twidget offers a variety of commands to help you manipulate lists easily without coding. Below is a detailed explanation of each command available. Get. Description: Returns the element in the provided list at the given index. Inputs: - `list`: The list from which to get the element. - `index`: The ...
