# Connector operations and every input field

Look up the operation names, required fields, examples, credentials, and request details in Rumata’s seeded connector catalog.

Source: https://docs.rumata.dev/guides/controls-connectors
Reviewed: 2026-09-06

## Before you start

- Open the named screen in Rumata. Available controls may depend on your account, permissions, and resource state.

<a id="catalog"></a>

## Using this catalog

Open [Add step](https://docs.rumata.dev/guides/controls-workflow-palette#catalog) in a workflow, choose a service, then choose its operation. This reference covers the seeded catalog; the server supplies the live list, so available connectors can change. All fields remain part of the graph draft until [Save](https://docs.rumata.dev/guides/controls-workflows#toolbar). Running the workflow sends the request and can change data in the external service.

| Control | What it does |
| --- | --- |
| Operation choice | Select the service task. Its fields appear in the step inspector. |
| Required marker / example placeholder | Complete required inputs. An example in an empty field is not an actual configured value. |
| ƒx / key icon | Use an expression for a request-body field or a saved secret where the key icon is offered. |

![Rumata Add a step palette beside an existing workflow, listing triggers and service connectors.](https://docs.rumata.dev/media/workflow-palette.jpg)

[Add a step](https://docs.rumata.dev/guides/controls-workflow-palette#catalog) groups triggers, connectors, activities, and control nodes. This reference capture uses a separate example factory. Select a step to review its configuration before adding it.

<a id="echo"></a>

## Echo (Postman)

A test API that returns a copy of your request and works without authentication or setup.

| Control | What it does |
| --- | --- |
| Send echo | Test a connector by sending a JSON body with POST and receiving it back. Complete the fields below, then save and run the workflow. |
| Send echo → Message | Required. Enter the message to send. Placeholder example (not saved): Hello from Rumata. |
| Send echo → Title | Optional. Enter the title. Placeholder example (not saved): optional. |
| Get with query | Send a GET request and receive the query parameters under `args`. Complete the fields below, then save and run the workflow. |
| Get with query → Query | Optional. Enter the query. Placeholder example (not saved): anything. |

<a id="slack"></a>

## Slack

Post messages and read channels via [Slack](https://docs.rumata.dev/guides/controls-connectors#slack)'s Web API.

| Control | What it does |
| --- | --- |
| Bot token | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer xoxb-…. |
| Send message | Post a message to a channel (chat.postMessage). Complete the fields below, then save and run the workflow. |
| Send message → Channel | Required. Enter the channel. Placeholder example (not saved): #general or C0123. |
| Send message → Text | Required. Enter the text to send. Placeholder example (not saved): Hello :wave:. |
| List channels | List the workspace's conversations (conversations.list). Complete the fields below, then save and run the workflow. |
| List channels → Limit | Optional. Set the limit. Placeholder example (not saved): 100. |

<a id="github"></a>

## GitHub

Create issues and read repositories on the [GitHub](https://docs.rumata.dev/guides/controls-connectors#github) REST API.

| Control | What it does |
| --- | --- |
| Personal access token | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer ghp_…. |
| Create issue | Open an issue on a repository. Complete the fields below, then save and run the workflow. |
| Create issue → Owner | Required. Enter the owner. Placeholder example (not saved): octocat. |
| Create issue → Repository | Required. Enter the repository. Placeholder example (not saved): hello-world. |
| Create issue → Title | Required. Enter the title. Placeholder example (not saved): Found a bug. |
| Create issue → Body | Optional. Enter the body. Placeholder example (not saved): Describe the issue…. |
| Get repository | Fetch a repository's metadata. Complete the fields below, then save and run the workflow. |
| Get repository → Owner | Required. Enter the owner. Placeholder example (not saved): octocat. |
| Get repository → Repository | Required. Enter the repository. Placeholder example (not saved): hello-world. |

<a id="telegram"></a>

## Telegram

Send messages through your [Telegram](https://docs.rumata.dev/guides/controls-connectors#telegram) bot.

| Control | What it does |
| --- | --- |
| Send message | Send a text message to a chat as your bot. Complete the fields below, then save and run the workflow. |
| Send message → Bot token | Required. Enter the token from @BotFather. Use a project secret in production. Placeholder example (not saved): 123456789:AAH…. |
| Send message → Chat ID | Required. Enter your numeric chat ID from @userinfobot or the bot's getUpdates. Placeholder example (not saved): 123456789. |
| Send message → Message | Required. Enter the message to send. Placeholder example (not saved): Hello from Rumata 👋. |
| Get updates | Poll for new incoming messages (long-polling, tunnel-free). Pass offset = last update_id + 1 to acknowledge. Complete the fields below, then save and run the workflow. |
| Get updates → Bot token | Required. Enter the token from @BotFather, using the same token as Send message. Placeholder example (not saved): 123456789:AAH…. |
| Get updates → Offset | Optional. Acknowledge all updates below this value, or leave it blank to read all pending updates. Placeholder example (not saved): (last update_id + 1). |
| Get updates → Limit | Optional. Set the limit. Placeholder example (not saved): 10. |

<a id="discord"></a>

## Discord

Send messages to a channel as your [Discord](https://docs.rumata.dev/guides/controls-connectors#discord) bot.

| Control | What it does |
| --- | --- |
| Bot token | Enter the service credential, preferably using the project-secret selector. Expected format: Bot MTA…. |
| Send channel message | Post a message to a channel (the bot must be in the server). Complete the fields below, then save and run the workflow. |
| Send channel message → Channel ID | Required. Enter the channel ID. Placeholder example (not saved): 1029384756. |
| Send channel message → Message | Required. Enter the message to send. Placeholder example (not saved): Hello from Rumata 👋. |

<a id="notion"></a>

## Notion

Create pages and query databases in your [Notion](https://docs.rumata.dev/guides/controls-connectors#notion) workspace.

| Control | What it does |
| --- | --- |
| Integration token | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer secret_…. |
| Query database | Return the pages (rows) of a database. Complete the fields below, then save and run the workflow. |
| Query database → Database ID | Required. Enter the database ID. Placeholder example (not saved): 32-char id. |
| Query database → Page size | Optional. Set the page size. Placeholder example (not saved): 10. |

<a id="sendgrid"></a>

## SendGrid

Send transactional email through [SendGrid](https://docs.rumata.dev/guides/controls-connectors#sendgrid).

| Control | What it does |
| --- | --- |
| API key | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer SG.…. |
| Send email | Send a single email. Use the ƒx toggle on a field to map dynamic data. Complete the fields below, then save and run the workflow. |
| Send email → Personalizations | Required. Toggle ƒx and paste the JSON array, e.g. [{"to":[{"email":"to@x.com"}]}]. Placeholder example (not saved): [{"to":[{"email":"to@x.com"}]}]. |
| Send email → From | Required. Toggle ƒx and paste {"email":"me@x.com"}. Placeholder example (not saved): {"email":"me@x.com"}. |
| Send email → Subject | Required. Enter the subject. Placeholder example (not saved): Hello. |
| Send email → Content | Required. Toggle ƒx and paste [{"type":"text/plain","value":"Hi"}]. Placeholder example (not saved): [{"type":"text/plain","value":"Hi"}]. |

<a id="openai"></a>

## OpenAI

Call [OpenAI](https://docs.rumata.dev/guides/controls-connectors#openai)'s chat completions API.

| Control | What it does |
| --- | --- |
| API key | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer sk-…. |
| Chat completion | Generate a chat completion. Toggle ƒx on Messages to map dynamic input. Complete the fields below, then save and run the workflow. |
| Chat completion → Model | Required. Specify the model. Placeholder example (not saved): gpt-5.6-terra. |
| Chat completion → Messages | Required. Toggle ƒx and paste the messages array. Placeholder example (not saved): [{"role":"user","content":"Hi"}]. |

<a id="anthropic"></a>

## Anthropic

Call the [Anthropic](https://docs.rumata.dev/guides/controls-connectors#anthropic) Claude Messages API.

| Control | What it does |
| --- | --- |
| API key | Enter the service credential, preferably using the project-secret selector. Expected format: sk-ant-…. |
| Create message | Generate a Claude response. Toggle ƒx on Messages to map dynamic input. Complete the fields below, then save and run the workflow. |
| Create message → Model | Required. Specify the model. Placeholder example (not saved): claude-sonnet-5. |
| Create message → Max tokens | Required. Set the maximum number of tokens. Placeholder example (not saved): 1024. |
| Create message → Messages | Required. Toggle ƒx and paste the messages array. Placeholder example (not saved): [{"role":"user","content":"Hi"}]. |

<a id="airtable"></a>

## Airtable

Read and create records in an [Airtable](https://docs.rumata.dev/guides/controls-connectors#airtable) base.

| Control | What it does |
| --- | --- |
| Personal access token | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer pat…. |
| Create record | Add a record to a table. Complete the fields below, then save and run the workflow. |
| Create record → Base ID | Required. Enter the base ID. Placeholder example (not saved): app…. |
| Create record → Table | Required. Enter the table. Placeholder example (not saved): Tasks. |
| Create record → Fields | Required. Toggle ƒx and paste a {field: value} object. Placeholder example (not saved): {"Name":"New task"}. |
| List records | List the records in a table. Complete the fields below, then save and run the workflow. |
| List records → Base ID | Required. Enter the base ID. Placeholder example (not saved): app…. |
| List records → Table | Required. Enter the table. Placeholder example (not saved): Tasks. |
| List records → Max records | Optional. Set the maximum number of records. Placeholder example (not saved): 10. |

<a id="hubspot"></a>

## HubSpot

Create CRM contacts in [HubSpot](https://docs.rumata.dev/guides/controls-connectors#hubspot).

| Control | What it does |
| --- | --- |
| Private app token | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer pat-…. |
| Create contact | Create a contact record. Complete the fields below, then save and run the workflow. |
| Create contact → Properties | Required. Toggle ƒx and paste a {property: value} object. Placeholder example (not saved): {"email":"a@b.com","firstname":"A"}. |

<a id="stripe"></a>

## Stripe

Read payments data from [Stripe](https://docs.rumata.dev/guides/controls-connectors#stripe).

| Control | What it does |
| --- | --- |
| Secret key | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer sk_test_…. |
| List customers | List your [Stripe](https://docs.rumata.dev/guides/controls-connectors#stripe) customers. Complete the fields below, then save and run the workflow. |
| List customers → Limit | Optional. Set the limit. Placeholder example (not saved): 10. |
| Get balance | Retrieve your current [Stripe](https://docs.rumata.dev/guides/controls-connectors#stripe) balance. Complete the fields below, then save and run the workflow. |

<a id="gitlab"></a>

## GitLab

Create issues on [GitLab](https://docs.rumata.dev/guides/controls-connectors#gitlab) (gitlab.com SaaS).

| Control | What it does |
| --- | --- |
| Access token | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer glpat-…. |
| Create issue | Open an issue on a project (URL-encode the project path or use its numeric id). Complete the fields below, then save and run the workflow. |
| Create issue → Project ID | Required. Enter the project ID. Placeholder example (not saved): 12345 or group%2Fproject. |
| Create issue → Title | Required. Enter the title. Placeholder example (not saved): Found a bug. |
| Create issue → Description | Optional. Enter the description. Placeholder example (not saved): Details…. |

<a id="jira"></a>

## Jira

Create issues in [Jira](https://docs.rumata.dev/guides/controls-connectors#jira) Cloud. Authenticate with Basic base64(email:apiToken).

| Control | What it does |
| --- | --- |
| Basic credential | Enter the service credential, preferably using the project-secret selector. Expected format: Basic <base64 email:token>. |
| Create issue | Create a [Jira](https://docs.rumata.dev/guides/controls-connectors#jira) issue. Toggle ƒx on Fields to pass the full ADF fields object. Complete the fields below, then save and run the workflow. |
| Create issue → Site | Required. The subdomain of your [Jira](https://docs.rumata.dev/guides/controls-connectors#jira) Cloud site (https://<site>.atlassian.net). Placeholder example (not saved): your-domain. |
| Create issue → Fields | Required. Toggle ƒx and paste the [Jira](https://docs.rumata.dev/guides/controls-connectors#jira) fields object. Placeholder example (not saved): {"project":{"key":"ABC"},"summary":"Hi","issuetype":{"name":"Task"}}. |

<a id="shopify"></a>

## Shopify

Read your [Shopify](https://docs.rumata.dev/guides/controls-connectors#shopify) store's data (Admin API).

| Control | What it does |
| --- | --- |
| Admin API token | Enter the service credential, preferably using the project-secret selector. Expected format: shpat_…. |
| Get shop | Fetch the store's metadata. Complete the fields below, then save and run the workflow. |
| Get shop → Shop | Required. The subdomain of your store (https://<shop>.myshopify.com). Placeholder example (not saved): my-store. |

<a id="asana"></a>

## Asana

Create tasks in [Asana](https://docs.rumata.dev/guides/controls-connectors#asana).

| Control | What it does |
| --- | --- |
| Personal access token | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer 1/…. |
| Create task | Create a task in a project or workspace. Complete the fields below, then save and run the workflow. |
| Create task → Task data | Required. Toggle ƒx and paste the [Asana](https://docs.rumata.dev/guides/controls-connectors#asana) task data object. Placeholder example (not saved): {"name":"New task","workspace":"123"}. |

<a id="trello"></a>

## Trello

Create cards on a [Trello](https://docs.rumata.dev/guides/controls-connectors#trello) board. Authenticate with key + token query parameters.

| Control | What it does |
| --- | --- |
| Create card | Add a card to a list. Complete the fields below, then save and run the workflow. |
| Create card → API key | Required. Enter the API key. Placeholder example (not saved): your-key. |
| Create card → API token | Required. Enter the API token. Placeholder example (not saved): your-token. |
| Create card → List ID | Required. Enter the list ID. Placeholder example (not saved): 5abbe4b…. |
| Create card → Card name | Required. Enter the card name. Placeholder example (not saved): New card. |

<a id="googlesheets"></a>

## Google Sheets

Append rows to a Google Sheet. Authenticate with an OAuth2 access token.

| Control | What it does |
| --- | --- |
| Access token | Enter the service credential, preferably using the project-secret selector. Expected format: Bearer ya29.…. |
| Append row | Append a row of values to a sheet range. Complete the fields below, then save and run the workflow. |
| Append row → Spreadsheet ID | Required. Enter the spreadsheet ID. Placeholder example (not saved): 1AbC…. |
| Append row → Range | Required. Set the range. Placeholder example (not saved): Sheet1!A1. |
| Append row → Value input option | Optional. Set the value input option. Placeholder example (not saved): RAW. |
| Append row → Values | Required. Toggle ƒx and paste a 2-D array of cell values. Placeholder example (not saved): [["a","b","c"]]. |

<a id="supabase"></a>

## Supabase

Read and write rows via your [Supabase](https://docs.rumata.dev/guides/controls-connectors#supabase) project's REST (PostgREST) API.

| Control | What it does |
| --- | --- |
| API key (service role or anon) | Enter the service credential, preferably using the project-secret selector. Expected format: eyJhbGci… (Project Settings → API). |
| Select rows | Read rows from a table (PostgREST). Use Select to pick columns and Filter for PostgREST operators. Complete the fields below, then save and run the workflow. |
| Select rows → Project ref | Required. Your project ref — the subdomain of <ref>.supabase.co. Placeholder example (not saved): abcdefgh. |
| Select rows → Table | Required. Enter the table. Placeholder example (not saved): todos. |
| Select rows → Select | Optional. Set the select value. Placeholder example (not saved): *. |
| Select rows → Limit | Optional. Set the limit. Placeholder example (not saved): 10. |
| Insert row | Insert a row (or rows) into a table. Toggle ƒx on Row to map dynamic data, or paste a JSON object. Complete the fields below, then save and run the workflow. |
| Insert row → Project ref | Required. Enter the project ref. Placeholder example (not saved): abcdefgh. |
| Insert row → Table | Required. Enter the table. Placeholder example (not saved): todos. |
| Insert row → Row | Required. The row object (sent as the bare PostgREST body). Toggle ƒx to map dynamic data, e.g. $ or [$]. Placeholder example (not saved): {"task":"Buy milk","done":false}. |

## Related guides

- [Activities](https://docs.rumata.dev/guides/system-explorer-activities)
- [AI workflow step and connector controls](https://docs.rumata.dev/guides/controls-workflow-agents)
- [Workflow step settings and data controls](https://docs.rumata.dev/guides/controls-workflow-nodes)