Messages

List direct-message conversations

Without conversationKey, every message for the profile, account or platform, oldest first. With conversationKey (which requires accountId; 400 invalid_request otherwise), one conversation read from the history Adeli stores: the newest limit messages (default 50, at most 100) before cursor, oldest first within the page, and nextCursor toward older messages (null at the start of the conversation). Each message carries its conversationKey.

get/api/v1/messages

Request

  • Base URL
    https://app.tryadeli.com
  • Auth
    HTTP bearer

Query parameters

platform'instagram' | 'tiktok' | 'tiktok_ads' | 'facebook' | 'meta_ads' | 'whatsapp' | 'youtube' | 'x' | 'bluesky' | 'linkedin' | 'linkedin_ads'
accountIdstring uuid
profileIdstring uuid
conversationKeystring

One conversation's messages: a message's conversationKey. Requires accountId. The response then holds the newest limit messages before cursor, oldest first, and nextCursor.

cursorstring

nextCursor from the previous page, toward older messages. Requires conversationKey.

limitinteger

Messages per page with conversationKey, 1–100. Defaults to 50.

Response

Success

status'complete' | 'partial' required
nextCursorstring nullable

Present only when conversationKey is given: pass it as cursor for the next, older page; null when there are no older messages.

Changes

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