Skip to main content

Build with Parabol

An intrepid space-faring team designs and builds an application with the Parabol API

Every retro, standup, and sprint poker meeting in Parabol is now programmable. Pull your team’s data out, push your systems’ data in, and let your AI agents do the busy-work — all through one GraphQL API.

curl -s https://action.parabol.co/graphql \
  -H "Authorization: Bearer $PARABOL_PAT" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ viewer { name teams { id name } } }"}'


What will you build?

Export and analyze. Pull retrospective themes, standup responses, and task data into your data warehouse, dashboards, or reports. Your team’s insights belong to you.

Sync with internal systems. Create tasks from support tickets, kick off retros from your release pipeline, or mirror Parabol activity into the tools your company already runs on.

Automate the rituals. Provision teams beyond what SCIM covers, schedule meetings from CI, and pin recurring agenda items — no clicking required.

Feed your AI agents. The API ships with agent-friendly metadata and llms.txt / llms-full.txt references, so an agent can discover what’s possible by introspection instead of documentation-spelunking. Our retro-reflect-bot reference app turns Slack history and GitHub activity into ready-made retro reflections.

How it works

  1. Create a token. Generate a Personal Access Token from your profile settings — any Parabol account, free or paid. Scope it to exactly the data it needs.
  2. Make a call. Send GraphQL over HTTPS to https://action.parabol.co/graphql with your token as a Bearer header. That’s the whole integration surface — one endpoint, strongly typed.
  3. Explore as you go. The same URL serves an interactive GraphiQL explorer in your browser, and the full schema is always one request away at /graphql/schema.graphql.

Secure by default

  • Scoped tokens. Sixteen granular scopes (meetings:read, tasks:write, …) — grant only what each integration needs.
  • Resource grants. Optionally restrict a token to specific organizations, teams, or pages. A token can never see more than you can.
  • Expiring credentials. Every token has an expiration date (up to one year) and can be revoked instantly from your profile.

Free to build on

The API is available on every plan. Free accounts get standard rate limits; paid plans get substantially higher throughput. And because Parabol is open source, you can read the resolvers behind every field you call. OAuth 2.0 support for third-party apps is on our roadmap — talk to us if you’re building something bigger.

Start building

From zero to your first API call in about five minutes — or jump straight to runnable code.