Sync and backfill Inbox
Runs existing Inbox polling or a bounded X backfill. Managed-X reads reserve both monthly allowance and the inbound daily cap before the paid X read; workspace_x_app bypasses UniPost X Credits.
Authorization
AuthorizationBearer <token>In header
Workspace API key. Inbox requires the Basic plan or higher.
Request Body
x_backfillobject
Include this object to run a bounded X reply/DM backfill. Omit it for the existing non-X Inbox sync.
x_backfill.account_idOptionalstring
Limit the operation to one eligible connected X account.
x_backfill.lookback_daysOptionalDefault: 7integer
1-30 days. X reply lookup is bounded to 7 days; DM lookup can use up to 30 days.
x_backfill.max_itemsOptionalDefault: 20integer
1-500 resources per source and account.
x_backfill.include_repliesOptionalboolean
Fetch eligible mentions and replies.
x_backfill.include_dmsOptionalboolean
Fetch legacy direct-message events.
x_backfill.confirmation_tokenOptionalstring
When the estimate exceeds the safe threshold, repeat the exact request with the returned one-time token before it expires.
Response Body
200
data.estimated_x_creditsinteger
Upper-bound managed-X estimate. workspace_x_app accounts contribute zero UniPost X Credits.
data.confirmation_requiredboolean
true when a second confirmed call is required before paid reads begin.
data.confirmation_tokenOptionalstring
Short-lived token bound to the exact account set, request, and estimate.
data.acceptedinteger
New items admitted to Inbox.
data.suppressedinteger
Items stopped by the managed-X monthly allowance or inbound daily cap.
data.details[].stop_reasonOptionalstring
Includes x_monthly_usage_limit_exceeded, x_inbound_daily_cap_exceeded, or reconnect_required.
data.details[].missing_scopesOptionalstring[]
X permissions that require reconnect.
400
plan_feature_not_available402
Inbox is unavailable below Basic.
validation_error400/409
The confirmation token is invalid, expired, already consumed, or no longer matches the frozen request.
not_found404
No eligible X account matched the request.
402
plan_feature_not_available402
Inbox is unavailable below Basic.
validation_error400/409
The confirmation token is invalid, expired, already consumed, or no longer matches the frozen request.
not_found404
No eligible X account matched the request.
409
plan_feature_not_available402
Inbox is unavailable below Basic.
validation_error400/409
The confirmation token is invalid, expired, already consumed, or no longer matches the frozen request.
not_found404
No eligible X account matched the request.