Skip to main content

Integration Guide

Connect Planra agents to any service using webhooks and HTTP requests

Slack (Native Integration)

Planra has a native Slack integration. Connect your workspace to Slack and agents can post messages, reply in threads, and respond to @mentions in real-time.

Setup

  1. Go to Preferences → Integrations → Connect Slack
  2. Authorize the Planra bot in your Slack workspace
  3. Set a default channel for agent notifications
  4. @mention Planra in any channel to chat with your agents

Agent Actions

  • slack_message — Post to any channel
  • slack_notify_team — Post to default channel
  • slack_thread_reply — Reply in a thread

Inbound Webhooks (Trigger Agents)

Any external service can trigger a Planra agent via webhook. Each agent has a unique webhook URL authenticated with a secret token.

Setup

  1. Go to Agents → select your agent → Config
  2. Add webhook_secret to the agent's config (any string you choose)
  3. Your webhook URL is: POST /api/agents/{agent_id}/webhook
  4. Include Authorization: Bearer {webhook_secret} header

Examples

GitHub → Planra:When a PR is merged, trigger the Sprint Planner to rebalance the sprint. Use GitHub Actions or Zapier to POST to your agent's webhook URL.
Zapier/Make → Planra: Connect any of 5000+ apps to trigger your agents automatically.

Outbound HTTP Requests (Agents Call APIs)

Agents can call any external HTTPS API using the http_request action. This enables integration with any service that has an API.

Safety

  • HTTPS only (HTTP blocked)
  • localhost and internal IPs blocked
  • 10-second timeout per request
  • Can be disabled per-agent via permissions (can_http: false)

Examples

Discord notifications: Agent uses http_request to POST to a Discord webhook URL.
Linear sync: Agent creates Linear issues via their API when tasks are created in Planra.
Notion export: Agent pushes project notes to Notion pages via their API.
Twilio SMS:Agent sends SMS alerts for critical task deadlines via Twilio's API.

Google Suite

Native integration with Google Calendar, Docs, and Sheets. Agents can sync tasks, create events, and export projects automatically.

Agent Actions

  • sync_calendar — Sync board tasks to Google Calendar
  • create_calendar_event — Create events with attendees
  • export_to_sheets — Export tasks to Google Sheets
  • export_to_docs — Export project plans to Google Docs

Building Custom Agents

Create custom agents with tailored prompts for your specific workflow. Here are some tips:

  • Be specific: "When overdue tasks are found, add a comment with the reason and bump priority to high"
  • Set boundaries: Use permissions to restrict what the agent can do (allowed_actions, can_delete: false)
  • Use schedules: Daily monitoring agents should run on a cron schedule (e.g., 0 8 * * * for 8 AM daily)
  • Chain agents: Have a monitoring agent trigger a reporting agent when issues are found
  • Test first: Run agents manually before enabling scheduled execution