{"schemaVersion":"1","contentVersion":"2026-10-18.1","slug":"controls-connectors","title":"Connector operations and every input field","summary":"Look up the operation names, required fields, examples, credentials, and request details in Rumata’s seeded connector catalog.","category":"Control reference","minutes":27,"prerequisites":["Open the named screen in Rumata. Available controls may depend on your account, permissions, and resource state."],"sections":[{"id":"catalog","title":"Using this catalog","blocks":[{"type":"paragraph","text":"Open [Add step](/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](/guides/controls-workflows#toolbar). Running the workflow sends the request and can change data in the external service."},{"type":"table","headers":["Control","What it does"],"rows":[["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."]]}]},{"id":"echo","title":"Echo (Postman)","blocks":[{"type":"paragraph","text":"A test API that returns a copy of your request and works without authentication or setup."},{"type":"table","headers":["Control","What it does"],"rows":[["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."]]}]},{"id":"slack","title":"Slack","blocks":[{"type":"paragraph","text":"Post messages and read channels via [Slack](/guides/controls-connectors#slack)'s Web API."},{"type":"table","headers":["Control","What it does"],"rows":[["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."]]}]},{"id":"github","title":"GitHub","blocks":[{"type":"paragraph","text":"Create issues and read repositories on the [GitHub](/guides/controls-connectors#github) REST API."},{"type":"table","headers":["Control","What it does"],"rows":[["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."]]}]},{"id":"telegram","title":"Telegram","blocks":[{"type":"paragraph","text":"Send messages through your [Telegram](/guides/controls-connectors#telegram) bot."},{"type":"table","headers":["Control","What it does"],"rows":[["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."]]}]},{"id":"discord","title":"Discord","blocks":[{"type":"paragraph","text":"Send messages to a channel as your [Discord](/guides/controls-connectors#discord) bot."},{"type":"table","headers":["Control","What it does"],"rows":[["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 👋."]]}]},{"id":"notion","title":"Notion","blocks":[{"type":"paragraph","text":"Create pages and query databases in your [Notion](/guides/controls-connectors#notion) workspace."},{"type":"table","headers":["Control","What it does"],"rows":[["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."]]}]},{"id":"sendgrid","title":"SendGrid","blocks":[{"type":"paragraph","text":"Send transactional email through [SendGrid](/guides/controls-connectors#sendgrid)."},{"type":"table","headers":["Control","What it does"],"rows":[["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\"}]."]]}]},{"id":"openai","title":"OpenAI","blocks":[{"type":"paragraph","text":"Call [OpenAI](/guides/controls-connectors#openai)'s chat completions API."},{"type":"table","headers":["Control","What it does"],"rows":[["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\"}]."]]}]},{"id":"anthropic","title":"Anthropic","blocks":[{"type":"paragraph","text":"Call the [Anthropic](/guides/controls-connectors#anthropic) Claude Messages API."},{"type":"table","headers":["Control","What it does"],"rows":[["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\"}]."]]}]},{"id":"airtable","title":"Airtable","blocks":[{"type":"paragraph","text":"Read and create records in an [Airtable](/guides/controls-connectors#airtable) base."},{"type":"table","headers":["Control","What it does"],"rows":[["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."]]}]},{"id":"hubspot","title":"HubSpot","blocks":[{"type":"paragraph","text":"Create CRM contacts in [HubSpot](/guides/controls-connectors#hubspot)."},{"type":"table","headers":["Control","What it does"],"rows":[["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\"}."]]}]},{"id":"stripe","title":"Stripe","blocks":[{"type":"paragraph","text":"Read payments data from [Stripe](/guides/controls-connectors#stripe)."},{"type":"table","headers":["Control","What it does"],"rows":[["Secret key","Enter the service credential, preferably using the project-secret selector. Expected format: Bearer sk_test_…."],["List customers","List your [Stripe](/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](/guides/controls-connectors#stripe) balance. Complete the fields below, then save and run the workflow."]]}]},{"id":"gitlab","title":"GitLab","blocks":[{"type":"paragraph","text":"Create issues on [GitLab](/guides/controls-connectors#gitlab) (gitlab.com SaaS)."},{"type":"table","headers":["Control","What it does"],"rows":[["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…."]]}]},{"id":"jira","title":"Jira","blocks":[{"type":"paragraph","text":"Create issues in [Jira](/guides/controls-connectors#jira) Cloud. Authenticate with Basic base64(email:apiToken)."},{"type":"table","headers":["Control","What it does"],"rows":[["Basic credential","Enter the service credential, preferably using the project-secret selector. Expected format: Basic <base64 email:token>."],["Create issue","Create a [Jira](/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](/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](/guides/controls-connectors#jira) fields object. Placeholder example (not saved): {\"project\":{\"key\":\"ABC\"},\"summary\":\"Hi\",\"issuetype\":{\"name\":\"Task\"}}."]]}]},{"id":"shopify","title":"Shopify","blocks":[{"type":"paragraph","text":"Read your [Shopify](/guides/controls-connectors#shopify) store's data (Admin API)."},{"type":"table","headers":["Control","What it does"],"rows":[["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."]]}]},{"id":"asana","title":"Asana","blocks":[{"type":"paragraph","text":"Create tasks in [Asana](/guides/controls-connectors#asana)."},{"type":"table","headers":["Control","What it does"],"rows":[["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](/guides/controls-connectors#asana) task data object. Placeholder example (not saved): {\"name\":\"New task\",\"workspace\":\"123\"}."]]}]},{"id":"trello","title":"Trello","blocks":[{"type":"paragraph","text":"Create cards on a [Trello](/guides/controls-connectors#trello) board. Authenticate with key + token query parameters."},{"type":"table","headers":["Control","What it does"],"rows":[["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."]]}]},{"id":"googlesheets","title":"Google Sheets","blocks":[{"type":"paragraph","text":"Append rows to a Google Sheet. Authenticate with an OAuth2 access token."},{"type":"table","headers":["Control","What it does"],"rows":[["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\"]]."]]}]},{"id":"supabase","title":"Supabase","blocks":[{"type":"paragraph","text":"Read and write rows via your [Supabase](/guides/controls-connectors#supabase) project's REST (PostgREST) API."},{"type":"table","headers":["Control","What it does"],"rows":[["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}."]]}]}],"technical":[],"related":["system-explorer-activities","controls-workflow-agents","controls-workflow-nodes"],"sources":["src/sql/system_init/connectors/catalog.json","components/window/explorer/graph-workflows/node-config/connector-fields.tsx"],"updated":"2026-09-06","audience":"general","media":[{"src":"https://docs.rumata.dev/media/workflow-palette.jpg","alt":"Rumata Add a step palette beside an existing workflow, listing triggers and service connectors.","caption":"[Add a step](/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.","width":1181,"height":834,"sectionId":"catalog"}],"video":null,"url":"https://docs.rumata.dev/guides/controls-connectors"}