Swarmauri Tool · Zapier Hook
A Swarmauri tool that triggers Zapier catch webhooks from within agent workflows. Use it to hand off conversation state to Zapier automations—send notifications, update CRMs, open tickets, or kick off custom Zaps with a single function call.
- Accepts JSON payloads as strings and posts them to a Zapier webhook URL.
- Surfaces the Zapier HTTP response (success or failure) in a structured dictionary.
- Built on
requestsso you can extend headers, authentication, or timeout behaviour if required.
Requirements
- Python 3.10 – 3.13.
- A Zapier webhook URL (copy from Zap setup → Webhooks by Zapier → Catch Hook). Store it securely (environment variables, secrets manager).
- Dependencies (
requests,swarmauri_base,swarmauri_standard,pydantic) install automatically with the package.
Installation
Pick the packaging workflow that fits your project; each command installs dependencies.
pip
pip install swarmauri_tool_zapierhook
Poetry
poetry add swarmauri_tool_zapierhook
uv
# Add to the current project and update uv.lock
uv add swarmauri_tool_zapierhook
# or install into the active environment without editing pyproject.toml
uv pip install swarmauri_tool_zapierhook
Tip: Treat the webhook URL like a secret. Avoid hardcoding it in source control and prefer environment variables.
Quick Start
import json
import os
from swarmauri_tool_zapierhook import ZapierHookTool
zap_url = os.environ["ZAPIER_WEBHOOK_URL"]
zap_tool = ZapierHookTool(zap_url=zap_url)
payload = json.dumps({
"message": "Hello from Swarmauri!",
"source": "webhook-demo"
})
result = zap_tool(payload)
print(result["zap_response"])
ZapierHookTool wraps the payload in a JSON object ({"data": payload}) before posting, matching the expectations of most Zapier catch hooks.
Usage Scenarios
Forward Agent Decisions to Zapier
from swarmauri_core.agent.Agent import Agent
from swarmauri_core.messages.HumanMessage import HumanMessage
from swarmauri_standard.tools.registry import ToolRegistry
from swarmauri_tool_zapierhook import ZapierHookTool
registry = ToolRegistry()
registry.register(ZapierHookTool(zap_url=os.environ["ZAPIER_WEBHOOK_URL"]))
agent = Agent(tool_registry=registry)
message = HumanMessage(content="log a follow-up task for the sales team")
response = agent.run(message)
print(response)
The agent can serialize conversation context, send it to Zapier, and continue the dialogue with confirmation details.
Escalate Incidents From Monitoring Scripts
import json
import os
from swarmauri_tool_zapierhook import ZapierHookTool
zap_tool = ZapierHookTool(zap_url=os.environ["INCIDENT_ZAP_URL"])
alert = {
"service": "payments",
"severity": "critical",
"message": "Latency exceeded threshold"
}
result = zap_tool(json.dumps(alert))
print("Zapier response:", result["zap_response"])
Trigger a Zap that files tickets, posts to Slack, or updates status pages when your monitoring detects issues.
Batch Replay Events
import json
import os
from swarmauri_tool_zapierhook import ZapierHookTool
zap_tool = ZapierHookTool(zap_url=os.environ["EVENT_ZAP_URL"])
with open("events.json") as fh:
events = json.load(fh)
for event in events:
payload = json.dumps(event)
zap_tool(payload)
Replay queued events into Zapier when systems come back online.
Troubleshooting
requests.exceptions.HTTPError– Zapier returned a non-200 status (often 401 due to malformed or revoked URLs). Check the webhook URL and payload format.- Timeouts or connection errors – Ensure the environment has outbound internet access and consider wrapping the tool to set explicit timeouts or retries.
- Zap expects structured JSON – The tool sends
{"data": payload}. Adjust your Zap’s “Catch Hook” step or extend the tool if you need different envelope fields.
License
swarmauri_tool_zapierhook is released under the Apache 2.0 License. See LICENSE for full details.
1 maintainer
Metadata
1 maintainer
Release files for swarmauri_tool_zapierhook 0.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| swarmauri_tool_zapierhook-0.9.0.tar.gz | 8.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| swarmauri_tool_zapierhook-0.9.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 18.1 kB
Release files / swarmauri_tool_zapierhook-0.9.0.tar.gz
| Download URL | swarmauri_tool_zapierhook-0.9.0.tar.gz |
|---|---|
| Size | 8.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
804305367a4eeb50bc58edd8230321b1bee2aa2ec8b62188b59c63d53c980c3f
|
|
BLAKE2b-256 checksum How to use checksums |
7139d5f5024458654f1f58d0b0b7a5e7c9a3a156bf59fdf423f738710c963a42
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.0 {"installer":{"name":"uv","version":"0.11.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / swarmauri_tool_zapierhook-0.9.0-py3-none-any.whl
| Download URL | swarmauri_tool_zapierhook-0.9.0-py3-none-any.whl |
|---|---|
| Size | 9.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bae73ae6b8037ee77d13227e6d8fba31fa91cd936eac17ec262543be055fd339
|
|
BLAKE2b-256 checksum How to use checksums |
09472cac212c92ba9312c767140e4faa982b828dedd2ae3249d67a098b2d74e6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.0 {"installer":{"name":"uv","version":"0.11.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
