← Back to Docs
⚡
Zapier Integration
Automate your availability with Zapier
Overview
Connect agentz.fyi with any of Zapier's 5000+ apps to automatically update your availability status. When events happen in other apps, Zapier can notify agentz.fyi to change your state.
Setup Guide
Step 1: Get Your Webhook URL
- Go to Dashboard → Webhooks
- Click "Create Webhook Token" if you haven't already
- Copy your webhook URL (click the eye icon to reveal the full URL)
Step 2: Create a Zap
- Go to Zapier and click "Create Zap"
- Choose your trigger app (e.g., Google Calendar, Slack, Zoom)
- Configure your trigger event
- For the action, choose "Webhooks by Zapier"
- Select "POST" as the action event
Step 3: Configure the Webhook
URL:
https://agentz.fyi/api/v1/webhook/wh_your_token_herePayload Type:
jsonData:
{
"state": "busy",
"reason": "In a meeting",
"source": "zapier"
}Sample Zaps
📅
Google Calendar → agentz.fyi
When a calendar event starts, set state to "meeting". When it ends, set state to "available".
Trigger: Event StartState: meeting
💬
Slack Status → agentz.fyi
When Slack status changes to DND, set state to "dnd".
Trigger: Status ChangeState: dnd
📹
Zoom Meeting → agentz.fyi
When you join a Zoom meeting, set state to "meeting".
Trigger: Meeting StartedState: meeting
🎯
Todoist Focus Mode → agentz.fyi
When you start a focus session in Todoist, set state to "focus".
Trigger: Focus StartedState: focus
Payload Reference
| Field | Type | Required | Description |
|---|---|---|---|
| state | string | Yes | available, busy, meeting, focus, dnd, away, sleeping |
| reason | string | No | Human-readable reason (e.g., "In standup") |
| until | ISO 8601 | No | When this state expires |
| source | string | No | Identifier for tracking (e.g., "zapier") |
Troubleshooting
401 Unauthorized
Your webhook token is invalid. Check that you're using the full URL with token.
429 Rate Limited
You've exceeded 60 requests per minute. Wait and retry.
400 Bad Request
Check that your state value is valid and the JSON is properly formatted.