Backfill Human Inbox

Run baseline and deep backfill flows for connected Human Inboxes.

View as Markdown

Human inboxes run a baseline backfill after connection. You can trigger additional sync as needed.

Trigger sync

POST /human/v0/accounts/{human_account_id}/sync

Backfill model

  • Baseline backfill captures recent mailbox state during onboarding.
  • Deeper enrichment consumes Deep Context credits according to your policy.
  • Sync scheduling and retries are handled by the continuous worker.

Operational tips

  • Use routing subscriptions to consume events incrementally after baseline import.
  • Track deep context usage in your usage dashboard before enabling large historical runs.

title: Backfill Human Inbox description: Trigger and manage historical sync for connected human accounts. surface: human

Human inbox sync supports baseline ingestion plus optional deeper historical enrichment.

Trigger Sync

curl -X POST "$API_URL/human/v0/accounts/{human_account_id}/sync" \
  -H "Authorization: Bearer $API_KEY"

Backfill Modes

  • Basic backfill: default account history sync.
  • Deep backfill: enrichment-oriented history processing that consumes deep context credits.

Operational Notes

  • Sync jobs are processed by the continuous worker.
  • Progress is visible through account sync state fields and downstream webhook events.