Developer documentation

Build accountability into every workflow.

Use the POIPAAS API to create, route, and verify accountability events directly from the systems your organization already uses.

API version 2026-07-01Base URL https://api.poipaas.com/v1

Authentication

Every request must include a scoped API key. Create keys in the POIPAAS console and store them securely—keys are shown only once.

HTTPAuthorization header
Authorization: Bearer po_live_••••••••••••••••••••

Create an accountability event

POST/events

Creates an event and submits it to your configured policy engine. Approved events are dispatched according to the recipient, coverage, and timing controls in your account.

cURLCreate event
curl https://api.poipaas.com/v1/events \
  -H "Authorization: Bearer $POIPAAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {
      "name": "Jordan Lee",
      "location_id": "loc_ind_8a2f"
    },
    "reason": "missed_delivery_commitment",
    "priority": "standard",
    "requested_window": "next_available"
  }'

Track resolution status

Events move through a controlled lifecycle. Subscribe to webhooks or retrieve an event directly to monitor each transition.

StatusMeaning
pending_reviewAwaiting policy evaluation.
approvedEligible for dispatch.
in_transitAssigned and actively routing.
resolvedDelivery evidence has been recorded.

Keep downstream systems informed.

Receive signed event updates when an accountability event changes state. Webhook delivery is included with every plan.

Request webhook access