Sign in

v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
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.

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)

account_idstring

Filter by connected account ID

eventstring

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

request_idstring

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)

status_codeinteger

Filter by exact HTTP status code (api_request logs)

api_key_idstring

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

include_read_receiptsboolean

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

Response

Logs retrieved successfully