Webhooks & integrations

WorkRight can push events out to where your team works. Outbound webhooks POST a message to Slack or Microsoft Teams when a chosen notification fires — a leave approval, an expense rejection, a locked payroll run, and more. Separately, each person can tune their own notification channels, and developers can integrate other systems through the public API.

• Webhooks: HR admins (company_admin / hr_manager) add and manage outbound webhooks. Others see them read-only.
• Notification preferences: every employee manages their own channel preferences and personal calendar feed — no admin role needed.
• Plan: integration features depend on your plan; see pricing.

1. Add an outbound webhook. Go to Settings → Webhooks and click Add webhook. Pick the provider (Slack or Microsoft Teams), paste the incoming-webhook URL, give it a label, and choose the notification type — a specific event, or “All notifications” to fire for everything.
2. Test it. The URL is stored encrypted and only ever shown masked after you save. Use Test to fire a sample event and confirm it lands in your channel, then check the delivery log on the webhook for the recent attempts and their status.
3. Tune your notifications. Each person opens Settings → Notifications to choose which channels (Email / In-app) receive each event type, and can generate a personal calendar feed (ICS) to subscribe to from their own calendar app.
4. Integrate over the API. For deeper integration — reading and writing data, or connecting an AI assistant — create an API token and use the public API.

• A webhook URL can't be edited after creation (it's stored encrypted) — to change it, delete the webhook and add a new one.
• Disable a webhook instead of deleting it if you only want to pause delivery — inactive webhooks are skipped, but their history stays.
• Start narrow: subscribe a channel to one event type first, then add “All notifications” once you're happy with the volume.

• Create an API token — authenticate code and AI assistants against the public API.
• API quickstart — base URL, scopes, rate limits and MCP setup.
• MCP server — connect WorkRight to an AI assistant.