mirror of
https://github.com/simstudioai/sim.git
synced 2026-04-06 03:00:16 -04:00
feat(tools): added zapier
This commit is contained in:
waleed
@@ -4151,7 +4151,7 @@ export function DuckDuckGoIcon(props: SVGProps<SVGSVGElement>) {
|
||||
return (
|
||||
<svg {...props} xmlns='http://www.w3.org/2000/svg' viewBox='-108 -108 216 216'>
|
||||
<circle r='108' fill='#d53' />
|
||||
<circle r='96' fill='none' stroke='#ffffff' stroke-width='7' />
|
||||
<circle r='96' fill='none' stroke='#ffffff' strokeWidth='7' />
|
||||
<path
|
||||
d='M-32-55C-62-48-51-6-51-6l19 93 7 3M-39-73h-8l11 4s-11 0-11 7c24-1 35 5 35 5'
|
||||
fill='#ddd'
|
||||
@@ -4199,3 +4199,25 @@ export function RssIcon(props: SVGProps<SVGSVGElement>) {
|
||||
</svg>
|
||||
)
|
||||
}
|
||||
|
||||
export function ZapierIcon(props: SVGProps<SVGSVGElement>) {
|
||||
return (
|
||||
<svg
|
||||
{...props}
|
||||
width='800px'
|
||||
height='800px'
|
||||
viewBox='0 0 256 256'
|
||||
version='1.1'
|
||||
xmlns='http://www.w3.org/2000/svg'
|
||||
xmlnsXlink='http://www.w3.org/1999/xlink'
|
||||
>
|
||||
<g>
|
||||
<path
|
||||
d='M128.080089,-0.000183105 C135.311053,0.0131003068 142.422517,0.624138494 149.335663,1.77979593 L149.335663,1.77979593 L149.335663,76.2997796 L202.166953,23.6044907 C208.002065,27.7488446 213.460883,32.3582023 218.507811,37.3926715 C223.557281,42.4271407 228.192318,47.8867213 232.346817,53.7047992 L232.346817,53.7047992 L179.512985,106.400063 L254.227854,106.400063 C255.387249,113.29414 256,120.36111 256,127.587243 L256,127.587243 L256,127.759881 C256,134.986013 255.387249,142.066204 254.227854,148.960282 L254.227854,148.960282 L179.500273,148.960282 L232.346817,201.642324 C228.192318,207.460402 223.557281,212.919983 218.523066,217.954452 L218.523066,217.954452 L218.507811,217.954452 C213.460883,222.988921 208.002065,227.6115 202.182208,231.742607 L202.182208,231.742607 L149.335663,179.04709 L149.335663,253.5672 C142.435229,254.723036 135.323765,255.333244 128.092802,255.348499 L128.092802,255.348499 L127.907197,255.348499 C120.673691,255.333244 113.590195,254.723036 106.677048,253.5672 L106.677048,253.5672 L106.677048,179.04709 L53.8457596,231.742607 C42.1780766,223.466917 31.977435,213.278734 23.6658953,201.642324 L23.6658953,201.642324 L76.4997269,148.960282 L1.78485803,148.960282 C0.612750404,142.052729 0,134.946095 0,127.719963 L0,127.719963 L0,127.349037 C0.0121454869,125.473817 0.134939797,123.182933 0.311311815,120.812834 L0.36577283,120.099764 C0.887996182,113.428547 1.78485803,106.400063 1.78485803,106.400063 L1.78485803,106.400063 L76.4997269,106.400063 L23.6658953,53.7047992 C27.8076812,47.8867213 32.4300059,42.4403618 37.4769335,37.4193681 L37.4769335,37.4193681 L37.5023588,37.3926715 C42.5391163,32.3582023 48.0106469,27.7488446 53.8457596,23.6044907 L53.8457596,23.6044907 L106.677048,76.2997796 L106.677048,1.77979593 C113.590195,0.624138494 120.688946,0.0131003068 127.932622,-0.000183105 L127.932622,-0.000183105 L128.080089,-0.000183105 Z M128.067377,95.7600714 L127.945335,95.7600714 C118.436262,95.7600714 109.32891,97.5001809 100.910584,100.661566 C97.7553011,109.043534 96.0085811,118.129275 95.9958684,127.613685 L95.9958684,127.733184 C96.0085811,137.217594 97.7553011,146.303589 100.923296,154.685303 C109.32891,157.846943 118.436262,159.587052 127.945335,159.587052 L128.067377,159.587052 C137.576449,159.587052 146.683802,157.846943 155.089415,154.685303 C158.257411,146.290368 160.004131,137.217594 160.004131,127.733184 L160.004131,127.613685 C160.004131,118.129275 158.257411,109.043534 155.089415,100.661566 C146.683802,97.5001809 137.576449,95.7600714 128.067377,95.7600714 Z'
|
||||
fill='#FF4A00'
|
||||
fillRule='nonzero'
|
||||
/>
|
||||
</g>
|
||||
</svg>
|
||||
)
|
||||
}
|
||||
|
||||
@@ -110,6 +110,7 @@ import {
|
||||
WordpressIcon,
|
||||
xIcon,
|
||||
YouTubeIcon,
|
||||
ZapierIcon,
|
||||
ZendeskIcon,
|
||||
ZepIcon,
|
||||
ZoomIcon,
|
||||
@@ -121,6 +122,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
|
||||
zoom: ZoomIcon,
|
||||
zep: ZepIcon,
|
||||
zendesk: ZendeskIcon,
|
||||
zapier: ZapierIcon,
|
||||
youtube: YouTubeIcon,
|
||||
x: xIcon,
|
||||
wordpress: WordpressIcon,
|
||||
|
||||
@@ -110,6 +110,7 @@
|
||||
"wordpress",
|
||||
"x",
|
||||
"youtube",
|
||||
"zapier",
|
||||
"zendesk",
|
||||
"zep",
|
||||
"zoom"
|
||||
|
||||
275
apps/docs/content/docs/en/tools/zapier.mdx
Normal file
275
apps/docs/content/docs/en/tools/zapier.mdx
Normal file
@@ -0,0 +1,275 @@
|
||||
---
|
||||
title: Zapier
|
||||
description: Execute actions across 7,000+ apps using Zapier AI Actions
|
||||
---
|
||||
|
||||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||||
|
||||
<BlockInfoCard
|
||||
type="zapier"
|
||||
color="#FFFFFF"
|
||||
/>
|
||||
|
||||
{/* MANUAL-CONTENT-START:intro */}
|
||||
[Zapier](https://zapier.com/) connects 7,000+ apps and automates workflows without manual coding. The Zapier integration in Sim empowers you to execute, search, build, and manage powerful AI-driven actions across thousands of applications—all with plain English instructions.
|
||||
|
||||
With Zapier AI Actions in Sim, you can:
|
||||
|
||||
- **Execute Actions:** Instantly trigger any stored AI Action in your Zapier account. Launch emails, messages, project updates, document workflows, CRM updates, and much more.
|
||||
- **List Actions:** Retrieve a list of your available AI Actions configured in Zapier. Discover what's possible and find the right tool for your workflow.
|
||||
- **Search Apps:** Find apps in Zapier’s ecosystem by name or keyword. Easily check if the app you need is supported before building automations.
|
||||
- **Find Actions (Guess):** Describe what you want to accomplish in plain English (e.g., "send a Slack message", "create a Google Sheet row"), and let Zapier’s AI suggest matching actions—even across unfamiliar apps or APIs.
|
||||
- **Create Actions:** Programmatically define new AI Actions by specifying the target app, action type (write, read, search), and required parameters, directly from your workflow.
|
||||
|
||||
By combining these capabilities, you can search for apps, define new AI Actions, discover possible automations, list available actions, and execute any workflow—fully automated, with the power of both Sim and Zapier.
|
||||
{/* MANUAL-CONTENT-END */}
|
||||
|
||||
|
||||
## Usage Instructions
|
||||
|
||||
Connect to Zapier AI Actions to execute any of 30,000+ actions across 7,000+ apps. Send emails, create documents, update CRMs, post messages, and more - all through natural language instructions. Requires a Zapier AI Actions API key.
|
||||
|
||||
|
||||
|
||||
## Tools
|
||||
|
||||
### `zapier_execute_action`
|
||||
|
||||
Execute a stored AI Action in Zapier. Runs any of the 30,000+ actions across 7,000+ apps that Zapier supports.
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Zapier AI Actions API key from actions.zapier.com/credentials |
|
||||
| `actionId` | string | Yes | The ID of the AI Action to execute |
|
||||
| `instructions` | string | Yes | Plain English instructions for what the action should do \(e.g., "Send a message about the weekly report to #general"\) |
|
||||
| `previewOnly` | boolean | No | If true, preview the execution without actually running it |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `executionLogId` | string | Unique identifier for this execution \(can be used for feedback\) |
|
||||
| `actionUsed` | string | Name of the action that was executed |
|
||||
| `inputParams` | json | Parameters that were passed to the API |
|
||||
| `resolvedParams` | json | Parameters that the AI resolved for execution |
|
||||
| `results` | json | Results from the action execution |
|
||||
| `resultFieldLabels` | json | Human-readable labels for result fields |
|
||||
| `status` | string | Execution status: success, error, empty, preview, or halted |
|
||||
| `error` | string | Error message if execution failed |
|
||||
|
||||
### `zapier_list_actions`
|
||||
|
||||
List all AI Actions configured in your Zapier account. Returns stored actions that can be executed.
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Zapier AI Actions API key from actions.zapier.com/credentials |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `actions` | json | Array of configured AI Actions with id, description, actionType, app, appLabel, action, actionLabel, params, accountId, authenticationId, needs |
|
||||
| `configurationLink` | string | Link to configure more actions in Zapier |
|
||||
|
||||
### `zapier_search_apps`
|
||||
|
||||
Search for apps available in Zapier. Returns apps with their available action counts.
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Zapier AI Actions API key from actions.zapier.com/credentials |
|
||||
| `query` | string | No | Optional search query to filter apps by name |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `apps` | json | Array of apps with app, name, logoUrl, authType, actions \(raw counts by type\), actionCount, writeActionCount, searchActionCount, readActionCount |
|
||||
|
||||
### `zapier_guess_actions`
|
||||
|
||||
Find relevant Zapier actions using natural language. Searches across 30,000+ actions to find the best matches for your query.
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Zapier AI Actions API key from actions.zapier.com/credentials |
|
||||
| `query` | string | Yes | Natural language description of what you want to do \(e.g., "send a Slack message", "create a Google Doc"\) |
|
||||
| `actionTypes` | array | No | Types of actions to search for: write, search, read. If not specified, returns all types. |
|
||||
| `count` | number | No | Maximum number of results to return \(default: 25\) |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `actions` | json | Array of matching actions with app, action, actionType, name \(combined app/action name\), description, image, and score |
|
||||
|
||||
### `zapier_create_action`
|
||||
|
||||
Create a new stored AI Action in Zapier. The action can then be executed with zapier_execute_action.
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Zapier AI Actions API key from actions.zapier.com/credentials |
|
||||
| `app` | string | Yes | The app identifier \(e.g., "slack", "gmail", "google-docs"\) |
|
||||
| `action` | string | Yes | The action identifier \(e.g., "send_channel_message", "send_email"\) |
|
||||
| `actionType` | string | No | Type of action: write, search, or read. Defaults to write. |
|
||||
| `accountId` | number | No | Zapier account ID |
|
||||
| `authenticationId` | number | No | Authentication ID for the app connection |
|
||||
| `meta` | json | No | Metadata object with params labels, app_label, action_label, authentication_label, app_needs_auth |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | The ID of the created AI Action \(use this with execute_action\) |
|
||||
| `description` | string | Description of the action |
|
||||
| `actionType` | string | Type of action \(write, search, read, read_bulk, search_or_write, search_and_write\) |
|
||||
| `app` | string | App identifier |
|
||||
| `appLabel` | string | Human-readable app label from meta |
|
||||
| `action` | string | Action identifier |
|
||||
| `actionLabel` | string | Human-readable action label from meta |
|
||||
|
||||
### `zapier_stateless_execute`
|
||||
|
||||
Execute any Zapier action directly without creating a stored AI Action first. Provide the app, action, and instructions.
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Zapier AI Actions API key from actions.zapier.com/credentials |
|
||||
| `app` | string | Yes | The app to use \(e.g., "SlackAPI", "GoogleSheetsV2API", "GmailV2API"\) |
|
||||
| `action` | string | Yes | The action to run \(e.g., "direct_message", "add_row", "send_email"\) |
|
||||
| `instructions` | string | Yes | Plain English instructions about how to run the action \(e.g., "Send a message saying hello to #general"\) |
|
||||
| `actionType` | string | No | Type of action: write, search, read, read_bulk, search_or_write, search_and_write |
|
||||
| `previewOnly` | boolean | No | If true, preview the execution without actually running it |
|
||||
| `authenticationId` | number | No | Authentication ID for the app connection |
|
||||
| `accountId` | number | No | Zapier account ID |
|
||||
| `providerId` | string | No | Provider ID for AI Actions |
|
||||
| `tokenBudget` | number | No | Max tokens per field \(default: 1000\) |
|
||||
| `skipParamGuessing` | boolean | No | Skip AI parameter guessing |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `executionLogId` | string | Unique identifier for this execution |
|
||||
| `actionUsed` | string | Name of the action that was executed |
|
||||
| `inputParams` | json | Parameters that were passed to the API |
|
||||
| `resolvedParams` | json | Parameters that the AI resolved for execution |
|
||||
| `results` | json | Results from the action execution |
|
||||
| `resultFieldLabels` | json | Human-readable labels for result fields |
|
||||
| `status` | string | Execution status: success, error, empty, preview, or halted |
|
||||
| `error` | string | Error message if execution failed |
|
||||
|
||||
### `zapier_search_app_actions`
|
||||
|
||||
Search for available actions within a specific Zapier app. Returns all actions the app supports.
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Zapier AI Actions API key from actions.zapier.com/credentials |
|
||||
| `app` | string | Yes | The app identifier to search actions for \(e.g., "SlackAPI", "GmailV2API"\) |
|
||||
| `query` | string | No | Optional search query to filter actions by name or description |
|
||||
| `actionTypes` | array | No | Filter by action types: write, search, read, read_bulk, search_or_write, search_and_write. Defaults to write and search. |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `actions` | json | Array of actions with app, action, actionType, displayName, description, relevancyScore, appNeedsAuth, appInfo |
|
||||
|
||||
### `zapier_get_action_details`
|
||||
|
||||
Get detailed information about a specific action including its required inputs (needs) and outputs (gives).
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Zapier AI Actions API key from actions.zapier.com/credentials |
|
||||
| `app` | string | Yes | The app identifier \(e.g., "SlackAPI", "GmailV2API"\) |
|
||||
| `action` | string | Yes | The action identifier \(e.g., "send_channel_message", "send_email"\) |
|
||||
| `actionType` | string | No | Type of action: write, search, read. Defaults to write. |
|
||||
| `includeNeeds` | boolean | No | Include input requirements \(needs\). Defaults to true. |
|
||||
| `includeGives` | boolean | No | Include output specifications \(gives\). Defaults to false. |
|
||||
| `includeSample` | boolean | No | Include sample execution result. Defaults to false. |
|
||||
| `accountId` | number | No | Zapier account ID |
|
||||
| `authenticationId` | number | No | Authentication ID for the app connection |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `action` | json | Action metadata including type, key, name, noun, and description |
|
||||
| `needs` | json | Array of input requirements with key, type, label, required, helpText, defaultValue, choices, dependsOn |
|
||||
| `gives` | json | Array of output fields with key, label, type, important, sample |
|
||||
| `sample` | json | Sample execution result if requested |
|
||||
| `customNeedsProbability` | number | Probability \(0-1\) that this action has custom/dynamic input fields |
|
||||
|
||||
### `zapier_update_action`
|
||||
|
||||
Update an existing stored AI Action configuration in Zapier.
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Zapier AI Actions API key from actions.zapier.com/credentials |
|
||||
| `actionId` | string | Yes | The ID of the AI Action to update |
|
||||
| `app` | string | Yes | The app identifier \(e.g., "SlackAPI", "GmailV2API"\) |
|
||||
| `action` | string | Yes | The action identifier \(e.g., "send_channel_message", "send_email"\) |
|
||||
| `actionType` | string | No | Type of action: write, search, read, read_bulk, search_or_write, search_and_write |
|
||||
| `accountId` | number | No | Zapier account ID |
|
||||
| `authenticationId` | number | No | Authentication ID for the app connection |
|
||||
| `meta` | json | No | Metadata object with params labels, app_label, action_label, authentication_label, app_needs_auth |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `id` | string | The ID of the updated AI Action |
|
||||
| `description` | string | Description of the action |
|
||||
| `actionType` | string | Type of action |
|
||||
| `app` | string | App identifier |
|
||||
| `appLabel` | string | Human-readable app label |
|
||||
| `action` | string | Action identifier |
|
||||
| `actionLabel` | string | Human-readable action label |
|
||||
|
||||
### `zapier_delete_action`
|
||||
|
||||
Delete a stored AI Action from Zapier.
|
||||
|
||||
#### Input
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
| --------- | ---- | -------- | ----------- |
|
||||
| `apiKey` | string | Yes | Zapier AI Actions API key from actions.zapier.com/credentials |
|
||||
| `actionId` | string | Yes | The ID of the AI Action to delete |
|
||||
|
||||
#### Output
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ---- | ----------- |
|
||||
| `deleted` | boolean | Whether the action was successfully deleted |
|
||||
| `message` | string | Status message |
|
||||
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
- Category: `tools`
|
||||
- Type: `zapier`
|
||||
Reference in New Issue
Block a user