# Zapier integration

### **1. What is Zapier?**

Zapier provides an easy way to connect your Toolhouse agents to thousands of supported apps such as such as Slack, Gmail, Google Sheets, Notion, while allowing your agents to take actions within those apps on your behalf

### Getting Started with Toolhouse and Zapier

In this guide, you’ll learn how to integrate Toolhouse with your Zapier workflows (Zaps). You can navigate [here](https://join.toolhouse.ai/) to get started with Toolhouse and [here](https://zapier.com/app/home) to get started with Zapier

### Choosing a trigger

Triggers are how you start automations in Zapier. These can be events such as getting a new email, a daily event, or a new row in Google sheets.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2F9NaypNWo3SOYkeC7Vqd4%2FUntitled%20(1).png?alt=media&#x26;token=12a08045-8cf6-400d-ac62-f9813edd856e" alt=""><figcaption></figcaption></figure>

In this example, the run is scheduled to trigger **every hour**.

Next, finish configuring your trigger by setting what time you want your automation to start

selecting whether you’d like it to run on **weekends**.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FK8Uy0v2KGEjSDTYufG1m%2FUntitled%20(2).png?alt=media&#x26;token=7d9580d9-cc6b-462b-b516-61dd1de9189b" alt=""><figcaption></figcaption></figure>

### Connecting Toolhouse to Your Zap

Toolhouse nodes can act as conductors in your zaps. They can process and transform incoming data, perform web crawling to gather additional context, and execute custom logic before handing structured results to downstream steps.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2F1MZZURmtCjXbTgHXWpBu%2FUntitled%20(3).png?alt=media&#x26;token=4a435a63-1100-443c-885e-6adf93e3f206" alt=""><figcaption></figcaption></figure>

Once you’ve finished testing your trigger, you can configure your Toolhouse node. Add a new step to your Zap and search for Toolhouse.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FUFMNLBneGiGaC5h1de7k%2FUntitled%20(4).png?alt=media&#x26;token=64e21427-c571-4ddf-a8d6-5b4c679a7953" alt=""><figcaption></figcaption></figure>

Click the **Sign in** button within the Account tab.

You’ll be redirected to a login page that looks like this:

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FVUSJre6nL98dqrr4ve0p%2FScreenshot%202025-07-28%20at%202.54.04%20PM.png?alt=media&#x26;token=d0436f13-7541-4207-b576-f6d626a5bfde" alt=""><figcaption></figcaption></figure>

#### Enter Your API Key

On the login page, you’ll be prompted to enter your Toolhouse API key.

You can find your API key in your Toolhouse dashboard under [API Keys](https://app.toolhouse.ai/settings/api-keys).

The API key page should look like this:

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FdlMFPECwl6jf8lzj6obh%2FScreenshot%202025-07-28%20at%202.55.02%20PM.png?alt=media&#x26;token=4a72efb4-4bd8-4428-b073-47c2fa3e9f71" alt=""><figcaption></figcaption></figure>

You can either **copy and paste** an existing key or **generate a new one** specifically for use with Zapier.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FEYICBX3v4jaEvf6znMsZ%2FScreenshot%202025-07-28%20at%202.55.59%20PM.png?alt=media&#x26;token=41031384-cd0d-478a-baad-07ae0367685e" alt=""><figcaption></figcaption></figure>

Once your Toolhouse account is successfully connected, it will appear under the **Account** dropdown in the Toolhouse event step.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FiFQ4WUUC6N3yuqrb7iBK%2FScreenshot%202025-07-28%20at%202.56.40%20PM.png?alt=media&#x26;token=75693b0e-e90f-4369-be23-e69b4840720d" alt=""><figcaption></figcaption></figure>

Next, select an **Action Event**.

For this example, we’ll choose **Send Agent a Message** to send a message to a Toolhouse agent.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2Fdz8ngUqPZIBMrxsuKuqu%2FScreenshot%202025-07-28%20at%202.57.14%20PM.png?alt=media&#x26;token=069cbca9-2de7-4578-ad3e-a9a23eeb9b13" alt=""><figcaption></figcaption></figure>

#### Configure Your Agent

Once you’ve selected an event, you can now configure your Toolhouse agent.

Choose the agent you want to use and fill in any required fields for the message.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FXGGwi38tClpUBpRp7fG3%2FScreenshot%202025-07-28%20at%202.57.44%20PM.png?alt=media&#x26;token=cdc8387c-3108-4140-b1d6-ceafcb7107e9" alt=""><figcaption></figcaption></figure>

#### Selecting an Agent

In the **Agent** dropdown, you'll see a list of all your existing Toolhouse agents.

> Note: If you don’t have any agents yet, click this link to create a preconfigured agent for free.
>
> [Create agent](https://app.toolhouse.ai/agents/new?message=retrieve+the+latest+tweets+about+Apple+and+respond+with+a+summary)

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FohvTYT5PCEO14RzEXDPW%2FScreenshot%202025-07-28%20at%203.01.08%20PM.png?alt=media&#x26;token=f7eb160d-591d-47e9-9586-79535f3d126f" alt=""><figcaption></figcaption></figure>

#### Writing Your Agent Message

Next, specify the message you want to send to your agent. This is where you tell the agent what to do.

For this example, the agent is designed to **classify tweets** as *positive*, *neutral*, or *negative*.

So the message might be something like:

**"Classify these Apple tweets by sentiment."**

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FuaqfwL6fkPtXv6Yw5NTJ%2FScreenshot%202025-07-28%20at%203.02.13%20PM.png?alt=media&#x26;token=d2c75f93-5f0a-450d-ac98-bbcac013f468" alt=""><figcaption></figcaption></figure>

Once you’ve finished configuring the Toolhouse step, you can **run a test** to make sure everything is working as expected and that your agent returns the correct results.

### Next Steps

Now that you’ve verified that your Toolhouse node works correctly, you can connect the output to other tools in your Zap. Toolhouse outputs can be mapped directly into downstream actions, enabling you to trigger notifications, store data, or kick off additional workflows.

Some common examples include **Discord** for sending messages or alerts, **Slack** for team notifications, **Google Sheets** for logging results, **Notion** for creating or updating records.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FniJsEbZHpEAPmGglk3Ys%2FUntitled%20(5).png?alt=media&#x26;token=317cf751-5684-415a-8565-54b714a49ffa" alt=""><figcaption></figcaption></figure>

in this example, we’ll be connecting to our **Discord** server to schedule messages in certain channels. This way, your Toolhouse agent can act as a Discord bot.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FMhmQeUlElXV54Oh5Qu8p%2FUntitled%20(6).png?alt=media&#x26;token=3fe5ca62-fd24-4ae3-8e58-241b15b398e2" alt=""><figcaption></figcaption></figure>

Once you’ve finished connecting your Discord account to Zapier, you can choose the message the automation will send. Since we want to use the output from the Toolhouse agent, click the **+** icon in the **Message Text** field and select **Agent Response**.

> **Note:** This step must come after the Toolhouse node so the agent’s response is available to use in the message.

This is how you can use outputs from your agents as inputs for actions in other apps. Once you’ve tested the output and verified that the message looks correct, click **Publish** to activate your Zap.

This is a good opportunity to review the output one final time before publishing and making your automation live.

<figure><img src="https://3896932452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fio16js3ONksvIYTf7YUl%2Fuploads%2FbshI5NhJsdMwDwOBazrr%2FScreenshot%202025-07-28%20at%203.03.17%20PM.png?alt=media&#x26;token=e4001c36-d125-4b2c-84a8-c02d89e0f3de" alt=""><figcaption></figcaption></figure>

#### Publish Your Zap

Once you hit **Publish**, your Zap will run on the schedule you configured.

You’ve now successfully integrated AI agents into your workflows using Toolhouse and Zapier!

If you don’t have an account yet, make one for free at <https://join.toolhouse.ai/>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/zapier-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
