Help Center

API & Webhooks

Peerdom provides a REST API and webhook system for building custom integrations. Use the API to read and write organizational data. Use webhooks to receive real-time notifications when your map changes.

REST API

Full API documentation is available at api.peerdom.org/v1/docs.

Authentication

Every API request requires an API key in the request headers. Each key operates within the context of a single organization.

To create an API key, go to Settings > My Data > API Keys in Organization Settings and click Create a key. Only users with Owner access rights can create and manage API keys.

API keys grant full read and write access to your organization's data. Treat them like passwords and never share them in public repositories or client-side code.

Use cases

The API supports a wide range of integrations:

  • Sync organizational data with your HRIS or people platform
  • Export roles, circles, and peer data for reporting
  • Build custom dashboards or internal tools
  • Feed organizational structure into other systems

Webhooks

Webhooks send HTTP POST requests to your endpoint whenever specific events occur in Peerdom. Configure webhooks in Settings > My Data > Webhooks within Organization Settings.

Available events

  • Role: Create, Update, Delete
  • Group: Create, Update, Delete
  • Peer: Create, Update, Delete

Testing your endpoint

Use the Test URL feature in the webhook configuration panel to validate your endpoint before saving. This sends a sample payload so you can confirm your server handles the request correctly.

Set up webhooks to trigger Zapier Zaps or n8n workflows in real time, rather than polling the API on a schedule.

Automation platforms

Several no-code and low-code platforms work well with the Peerdom API:

  • Zapier: Connect Peerdom to 7,000+ apps with a visual workflow builder. See the Zapier integration guide.
  • Pipedream: Developer-friendly platform with HTTP triggers, custom code steps (JavaScript and Python), and a generous free tier.
  • n8n: Open-source and self-hostable workflow automation with HTTP Request nodes and over 400 built-in integrations.

All three platforms can consume Peerdom webhooks and call the REST API to create bidirectional workflows.