Integrations
DataPlannedExport

Read API & Webhooks

Your data, readable by you. Not locked behind a dashboard.

Agencies manage many tenants and need programmatic access: conversion status feeds, campaign aggregates, delivery receipts. Scoped tokens return aggregates per tenant, webhooks push status changes as they happen, and every payload replays by delivery id.

Pages marked Planned are complete specifications written before the connector ships. They validate demand. Connectors with real delivery logs are marked Production or Beta.

Reporting by screenshot does not scale

Without read access, every client report means logging into another dashboard. Data you paid to generate should not require manual exports to be useful.

One deterministic contract for every tenant you run

Read aggregates grouped by campaign or window, receive webhook calls when outcomes confirm or retract, and feed your own BI or client reports from the same source of truth the ad platforms see.

What you can read

conversion_status_feedcampaign_aggregatesdelivery_receiptstenant_event_stream

How the data flows

  1. Agency connects one workspace covering all its tenants
  2. Scoped read token returns aggregates, never raw patient data
  3. Webhooks push conversion status changes as they happen
  4. Dashboards and reports read from one deterministic contract
  5. Every payload is idempotent and replayable by delivery id

How the connection works

  1. Create a workspace-scoped read token (aggregates only, no raw records).

  2. Subscribe webhooks for conversion.delivered, conversion.failed, outcome.confirmed, and outcome.retracted.

  3. Poll or listen; every event carries a replayable delivery id.

  4. Point your dashboards at the same numbers the ad platforms receive.

Event mapping

FromApointoo
GET /v1/conversions?tenant=&window=conversion_status_feed
GET /v1/aggregates?groupBy=campaigncampaign_aggregates
Webhook: conversion.delivered / conversion.faileddelivery_receipts
Webhook: outcome.confirmed / outcome.retractedtenant_event_stream

Frequently asked questions

Your data, readable by you. Not locked behind a dashboard.

No. The read surface serves aggregates and status by design. Clinical records stay in the tenant dashboard under their existing access controls.