POpostproxy
Profiles

Backfill chats

Walks an Instagram or Facebook profile's conversations from the most recently active backwards, and each conversation's messages from the newest backwards, until both reach from, importing anything missing. Runs in the background - the response is the chat sync record, which you poll for progress. Backfilled messages do not fire message.received.

post/api/profiles/{id}/backfill_chats

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/profiles/{id}/backfill_chats
  • Auth
    HTTP bearer

Path parameters

idstring required

Profile id

Query parameters

profile_group_idstring

Profile group context for the request. Optional when the API key is scoped to a profile group (that group is used automatically); with a full-access key, defaults to the first profile group in the account.

Headers

Idempotency-Keystring

Optional idempotency key (up to 255 characters; a UUID is ideal). Retrying a successful write with the same key replays the original response (with an Idempotent-Replay: true header) instead of executing again. Stored responses are kept for 24 hours; only 2xx responses are stored.

Request body

fromstring required

ISO 8601 date/time, or a bare date meaning that date's start of day. Conversations last active before this are not opened; inside a conversation the run stops at the first message sent before this.

Response

Backfill accepted; returns the chat sync record to poll for progress

idstring

Unique sync identifier.

profile_idstring

Profile this run belongs to.

placement_idstring nullable

Always null for chat syncs.

kind'chats'

Always chats.

trigger'connect' | 'backfill'
status'pending' | 'running' | 'completed' | 'failed'
started_atstring nullable

ISO 8601 timestamp when the run began.

completed_atstring nullable

ISO 8601 timestamp when it finished or failed.

chats_seeninteger

Conversations the platform returned across the run.

messages_importedinteger

Messages that were new and got created. Messages you already have are skipped and not counted.

backfill_fromstring nullable

The date floor requested. null for connect runs.

oldest_updated_atstring nullable

Last-activity time of the oldest conversation the run reached - how far back it has walked.

errorstring nullable

Platform error message when status is failed.

created_atstring

ISO 8601 timestamp.

Changes

No recorded changes to this operation across all 1 revision of this API.