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.
Get started
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_••••••••••••••••••••
Events
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"
}'
Event lifecycle
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.Webhooks
Keep downstream systems informed.
Receive signed event updates when an accountability event changes state. Webhook delivery is included with every plan.
Request webhook access