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.
Metadata
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 | Provenance | Actions |
|---|---|---|---|---|
| swarmauri_tool_zapierhook-0.9.0.tar.gz | 8.5 kB | Without provenance | Details for swarmauri_tool_zapierhook-0.9.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| swarmauri_tool_zapierhook-0.9.0-py3-none-any.whl | Python 3 | none | any | Details for swarmauri_tool_zapierhook-0.9.0-py3-none-any.whl |
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}
|
Security for swarmauri_tool_zapierhook 0.9.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.