Sign in
Logs

List activity logs

Unified logs endpoint. Returns logs for publishing, connections, webhooks, and messaging. Filter by type, platform, status, and time range. Logs are retained for 90 days. Legacy query aliases remain accepted: account_id for accountId, request_id for requestId, status_code for statusCode, api_key_id for apiKeyId, and include_read_receipts for includeReadReceipts.

get/v1/logs

Query parameters

type'all' | 'publishing' | 'connections' | 'webhooks' | 'messaging' | 'workflow_event' | 'api_request'

Log category to query. Use all for the unified view across every category, or api_request for your API request logs (method, path, status, latency).

status'success' | 'failed' | 'pending' | 'skipped' | 'all'

Filter by status

platform'tiktok' | 'instagram' | 'whatsapp' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'all'

Filter by platform

actionstring

Filter by action (e.g., post.published, message.sent, account.connected, webhook.delivered)

searchstring

Free-text search across log fields

daysinteger

Number of days to look back (max 90)

limitinteger

Maximum number of logs to return (max 100)

skipinteger

Number of logs to skip (for pagination)

accountIdstring

Filter by connected account ID

eventstring

Filter webhook logs by event (e.g. post.published, message.received)

requestIdstring

Correlation ID. Returns every log spawned by a single API request

fromstring date-time

Precise start instant (ISO 8601); narrows within the day range

tostring date-time

Precise end instant (ISO 8601)

statusCodeinteger

Filter by exact HTTP status code (api_request logs)

apiKeyIdstring

Filter by the API key that made the request (api_request logs)

includeReadReceiptsboolean

Include message.read / message.delivered events (hidden by default for messaging logs)

Response

Logs retrieved successfully

Changes

Changed in 1 of the 56 revisions of this API.56

  • dd3865482f9f56See the full diff
    • ●

      deleted the query request parameter account_id

      request-parameter-removed

    • ●

      deleted the query request parameter api_key_id

      request-parameter-removed

    • ●

      deleted the query request parameter include_read_receipts

      request-parameter-removed

    • ●

      deleted the query request parameter request_id

      request-parameter-removed

    • ●

      deleted the query request parameter status_code

      request-parameter-removed

    • ○

      added the new optional query request parameter accountId

      new-optional-request-parameter

    • ○

      added the new optional query request parameter apiKeyId

      new-optional-request-parameter

    • ○

      added the new optional query request parameter includeReadReceipts

      new-optional-request-parameter

    • ○

      added the new optional query request parameter requestId

      new-optional-request-parameter

    • ○

      added the new optional query request parameter statusCode

      new-optional-request-parameter

    • ○

      added the non-success response with the status

      response-non-success-status-added