> ## Documentation Index
> Fetch the complete documentation index at: https://iotools.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapier integration

> Run any IOTools.cloud tool from a Zap with the IO Tools integration

The **IO Tools** integration for [Zapier](https://zapier.com) calls the same public API you already use for REST, MCP or n8n: same key, same credits, same 800+ tools.

<Info>
  The integration calls the API and MCP surface while it's still in **Beta** — see [API overview](/docs/api/overview).
</Info>

<Note>
  Currently a **private** Zapier integration, not yet listed in Zapier's public App Directory — [accept the invite link](https://zapier.com/developer/public-invite/244610/2afe488fea7bf818103eaa43a0f3a367/) to connect it. No approval needed on your end; searching for "IO Tools" inside Zapier itself won't find it yet.
</Note>

## Install

[Accept the invite](https://zapier.com/developer/public-invite/244610/2afe488fea7bf818103eaa43a0f3a367/), then add **IO Tools** to a Zap like any other app — it'll show up under "My Apps" from then on.

## Credentials

Add an **iotools.cloud API** connection:

| Field        | Value                                                                        |
| ------------ | ---------------------------------------------------------------------------- |
| **API Key**  | Mint one under [Account → API keys](https://iotools.cloud/account/#api-keys) |
| **Base URL** | Defaults to `https://api.iotools.cloud/v1`                                   |

## Operations

One integration, four operations:

| Type    | Name                   | What it does                                      |
| ------- | ---------------------- | ------------------------------------------------- |
| Trigger | **New Tool Published** | Fires when a new tool is added to the catalog     |
| Search  | **Find Tool**          | Find a tool by name, slug, description or tag     |
| Action  | **Run Tool**           | Pick a tool, fill its fields, run it              |
| Action  | **Get Credits**        | The key's remaining credit balance and rate limit |

### Run Tool

* **Tool** — a searchable dropdown populated from the catalog.
* The fields below it are populated dynamically from the selected tool's input schema — enums become dropdowns with choices, scalar arrays become repeatable fields, everything else maps to a string, number or boolean field. A base64-blob field (single or array-of) falls back to a plain string — paste base64 text — there's no Zapier field type for a raw blob.
* **Additional Fields (JSON)** — a JSON object merged on top of the fields above, for anything they can't represent well, or to override a single field with a Zapier expression. Defaults to `{}` (no-op).
* **Simplify Output** — on by default, returns just the tool's `outputs`; off returns the full response envelope (`tool`, `tool_version`, `outputs`, `credits_used`, `credits_remaining`).

A failed call throws using the API's own [RFC 9457 problem document](/docs/concepts/errors) — the error message is the specific `detail` (falling back to the category title).

## Rate limits

API keys are limited to 60 requests/minute per endpoint on the free tier (higher on paid tiers). A rate-limited call is retried automatically by Zapier's own platform — not something the integration has to implement — respecting the wait time the API reports; only a rate limit that outlasts Zapier's own retry budget surfaces as an error. See [Rate limits](/docs/concepts/rate-limits).

## Cost

Same meter as REST, MCP and n8n: every **Run Tool** call costs the tool's own credits, refunded if the call fails. **New Tool Published**, **Find Tool** and **Get Credits** are free. See [Credits](/docs/concepts/credits).

## Troubleshooting

| Symptom                                                | Cause                                                                                                                                                                    |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Can't find "IO Tools" searching Zapier's App Directory | Still a private integration — use the [invite link](https://zapier.com/developer/public-invite/244610/2afe488fea7bf818103eaa43a0f3a367/) above, not App Directory search |
| Every call fails with `invalid_api_key`                | Key revoked, or the connection's Base URL doesn't match where the key was minted                                                                                         |
| `insufficient_credits`                                 | Out of credits for the month — see [Credits](/docs/concepts/credits)                                                                                                          |