FunnelFlux Pro API DocumentsFunnelFlux Pro API Documents
  • Changelog
  • Status
  • Dashboard
  • Documentation
  • Authentication
  • Domains
  • Assets
  • Reporting
Information
Reporting
    List available attributesgetCreate a drilldown reportpostCreate a raw event reportpost
Updates
    Submit a conversion updateputSubmit a custom event updateputSubmit a cost updateputValidate a data resetpostPerform a data resetdelete
Logs
    Get postback logpostGet webhook asset summarypostGet middleware asset summarypostGet incoming postback logspostGet integration logspostGet integration queue rowspostGet postback logpost
Explorer
    Look up a visitorpostLook up a single hitpost
Schemas
FunnelFlux Reporting API
FunnelFlux Reporting API

Logs

Download schema

Postback log endpoints


Get postback log

POST
https://api.funnelflux.pro/v1
/reporting/logs/postbacks

Returns postback log for specified criteria.

Get postback log › Request Body

PostbackLogParams
timeStart
​string · date-time · required
timeEnd
​string · date-time · required
pagingLength
​integer · int32 · min: 1 · max: 10000 · required
​PostbackLogAttributeData[]
sort
​string · enum
Enum values:
asc
desc
Default: desc
pagingStart
​integer · int32 · min: 0
Default: 0
restrictToMetrics
​string[]

If empty, returns default metrics. Can restrict the response to any combination of the following metrics:

  • Time
  • URL
  • Owner
  • FunnelID
  • TrafficSourceID
  • HitID
  • ConversionID
  • TransactionID
  • EventNumber
  • Payout
  • Error
  • ResponseStatusCode
  • ResponseBody
  • Try
  • LastTry
  • IsIntegration
  • IntegrationId
  • QueryString
  • FunnelName
  • TrafficSourceName
  • PageID
  • PageName
  • PageCategoryName
  • OfferSourceName
  • HasPiiEmail
  • HasPiiPhone
  • HasPiiZipcode
  • HasDedupeEventId

Get postback log › Responses

The requested report

PostbackLogReport
​PostbackLogReportRow[]
POST/reporting/logs/postbacks
curl --request POST \ --url https://api.funnelflux.pro/v1/reporting/logs/postbacks \ --header 'Content-Type: application/json' \ --data ' { "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "filters": [ { "attribute": "Time", "whitelistFilters": [ "string" ], "blacklistFilters": [ "string" ] } ], "sort": "desc", "pagingStart": 0, "pagingLength": 1, "restrictToMetrics": [ "string" ] } '
Example Request Body
{ "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "filters": [ { "attribute": "Time", "whitelistFilters": [ "string" ], "blacklistFilters": [ "string" ] } ], "sort": "desc", "pagingStart": 0, "pagingLength": 1, "restrictToMetrics": [ "string" ] }
json
Example Responses
{ "rows": [ { "time": "2024-08-25T15:00:00Z", "url": "url", "owner": "owner", "funnelID": "funnelID", "trafficSourceID": "trafficSourceID", "hitID": "hitID", "conversionID": "conversionID", "transactionID": "transactionID", "eventNumber": 0, "payout": 0, "error": "error", "responseStatusCode": 0, "responseBody": "responseBody", "try": 0, "lastTry": 0, "isIntegration": "isIntegration", "integrationId": "integrationId", "queryString": "queryString", "funnelName": "funnelName", "trafficSourceName": "trafficSourceName", "pageID": "pageID", "pageName": "pageName", "pageCategoryName": "pageCategoryName", "offerSourceName": "offerSourceName", "hasPiiEmail": true, "hasPiiPhone": true, "hasPiiZipcode": true, "hasDedupeEventId": true } ] }
json
application/json

Get webhook asset summary

POST
https://api.funnelflux.pro/v1
/reporting/logs/webhooks/summary

Returns current webhook config assets merged with webhook delivery log aggregates.

Get webhook asset summary › Request Body

WebhookSummaryParams
timeStart
​string · date-time · required
timeEnd
​string · date-time · required
statusFilter
​string · enum
Enum values:
active
archived
deleted
not-deleted
all
Default: not-deleted
groupBy
​string[]
Enum values:
webhookConfig
category
targetType
idWebhookConfigs
​string[]
idCategories
​string[]
targetTypes
​string[]
Enum values:
custom
zapier
make
pipedream
pipedrive
n8n
tray_io
ifttt
includeAssetsWithoutTraffic
​boolean
Default: false

Get webhook asset summary › Responses

The requested summary

WebhookSummaryReport
​WebhookSummaryReportRow[]
POST/reporting/logs/webhooks/summary
curl --request POST \ --url https://api.funnelflux.pro/v1/reporting/logs/webhooks/summary \ --header 'Content-Type: application/json' \ --data ' { "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "statusFilter": "not-deleted", "groupBy": [ "webhookConfig" ], "idWebhookConfigs": [ "string" ], "idCategories": [ "string" ], "targetTypes": [ "custom" ], "includeAssetsWithoutTraffic": false } '
Example Request Body
{ "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "statusFilter": "not-deleted", "groupBy": [ "webhookConfig" ], "idWebhookConfigs": [ "string" ], "idCategories": [ "string" ], "targetTypes": [ "custom" ], "includeAssetsWithoutTraffic": false }
json
Example Responses
{ "rows": [ { "idWebhookConfig": "idWebhookConfig", "webhookConfigName": "webhookConfigName", "idCategory": "idCategory", "categoryName": "categoryName", "targetType": "custom", "status": "active", "enabled": true, "executionCount": 0, "successCount": 0, "failureCount": 0, "nodeExecutionCount": 0, "onActionCount": 0, "conversionTriggeredCount": 0, "customEventTriggeredCount": 0 } ] }
json
application/json

Get middleware asset summary

POST
https://api.funnelflux.pro/v1
/reporting/logs/middleware/summary

Returns current middleware config assets merged with middleware execution log aggregates.

Get middleware asset summary › Request Body

MiddlewareSummaryParams
timeStart
​string · date-time · required
timeEnd
​string · date-time · required
statusFilter
​string · enum
Enum values:
active
archived
disabled
deleted
not-deleted
all
Default: not-deleted
groupBy
​string[]
Enum values:
middlewareConfig
category
destinationType
idMiddlewareConfigs
​string[]
idCategories
​string[]
destinationTypes
​string[]
Enum values:
custom
zapier
make
pipedream
pipedrive
n8n
tray_io
ifttt
includeAssetsWithoutTraffic
​boolean
Default: false

Get middleware asset summary › Responses

The requested summary

MiddlewareSummaryReport
​MiddlewareSummaryReportRow[]
POST/reporting/logs/middleware/summary
curl --request POST \ --url https://api.funnelflux.pro/v1/reporting/logs/middleware/summary \ --header 'Content-Type: application/json' \ --data ' { "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "statusFilter": "not-deleted", "groupBy": [ "middlewareConfig" ], "idMiddlewareConfigs": [ "string" ], "idCategories": [ "string" ], "destinationTypes": [ "custom" ], "includeAssetsWithoutTraffic": false } '
Example Request Body
{ "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "statusFilter": "not-deleted", "groupBy": [ "middlewareConfig" ], "idMiddlewareConfigs": [ "string" ], "idCategories": [ "string" ], "destinationTypes": [ "custom" ], "includeAssetsWithoutTraffic": false }
json
Example Responses
{ "rows": [ { "idMiddlewareConfig": "idMiddlewareConfig", "middlewareConfigName": "middlewareConfigName", "idCategory": "idCategory", "categoryName": "categoryName", "destinationType": "custom", "status": "active", "executionCount": 0, "successCount": 0, "failureCount": 0, "timeoutCount": 0, "successRate": 0, "failureRate": 0, "averageLatencyMs": 0 } ] }
json
application/json

Get incoming postback logs

POST
https://api.funnelflux.pro/v1
/reporting/logs/incoming-postbacks

Returns incoming postback request logs (server-to-server requests received on /pb/ and /pb/cevent).

Get incoming postback logs › Request Body

IncomingPostbackLogParams
timeStart
​string · date-time · required
timeEnd
​string · date-time · required
pagingLength
​integer · int32 · min: 1 · max: 10000 · required
​IncomingPostbackLogAttributeData[]
sort
​string · enum
Enum values:
asc
desc
Default: desc
pagingStart
​integer · int32 · min: 0
Default: 0
restrictToMetrics
​string[]

Optional requested row fields. When set, the response and SQL projection contain only these fields. Valid values are Time, Owner, RequestID, Domain, Path, Method, PostbackType, Status, ErrorCode, ErrorMessage, ResponseStatusCode, ClientIP, UserAgent, Referer, HitID, EventNumber, Revenue, TransactionID, EventData1, EventData2, ConversionTime, RevShare, DisablePostbacks, ForcePostbacks, HasPiiEmail, HasPiiPhone, HasPiiZipcode, HasDedupeEventId.

Enum values:
Time
Owner
RequestID
Domain
Path
Method
PostbackType
Status

Get incoming postback logs › Responses

The requested report

IncomingPostbackLogReport
​IncomingPostbackLogReportRow[]
POST/reporting/logs/incoming-postbacks
curl --request POST \ --url https://api.funnelflux.pro/v1/reporting/logs/incoming-postbacks \ --header 'Content-Type: application/json' \ --data ' { "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "filters": [ { "attribute": "attribute", "whitelistFilters": [ "string" ], "blacklistFilters": [ "string" ] } ], "sort": "desc", "pagingStart": 0, "pagingLength": 1, "restrictToMetrics": [ "Time" ] } '
Example Request Body
{ "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "filters": [ { "attribute": "attribute", "whitelistFilters": [ "string" ], "blacklistFilters": [ "string" ] } ], "sort": "desc", "pagingStart": 0, "pagingLength": 1, "restrictToMetrics": [ "Time" ] }
json
Example Responses
{ "rows": [ { "time": "time", "owner": "owner", "requestID": "requestID", "domain": "domain", "path": "path", "method": "method", "postbackType": "postbackType", "status": "status", "errorCode": "errorCode", "errorMessage": "errorMessage", "responseStatusCode": 0, "clientIP": "clientIP", "userAgent": "userAgent", "referer": "referer", "hitID": "hitID", "eventNumber": 0, "revenue": "revenue", "transactionID": "transactionID", "eventData1": "eventData1", "eventData2": "eventData2", "conversionTime": "conversionTime", "revShare": "revShare", "disablePostbacks": "disablePostbacks", "forcePostbacks": "forcePostbacks", "hasPiiEmail": true, "hasPiiPhone": true, "hasPiiZipcode": true, "hasDedupeEventId": true } ] }
json
application/json

Get integration logs

POST
https://api.funnelflux.pro/v1
/reporting/logs/integrations

Returns integration logs (conversion delivery and connection_auth) for specified criteria. Each row includes outcome (queued, delivered, skipped, failed, or unknown when the stored outcome is empty) and outcomeReason. Outcome filter values are queued, delivered, skipped, failed, and unknown. unknown matches a stored empty outcome. There is no default exclusion.

Get integration logs › Request Body

IntegrationLogParams
timeStart
​string · date-time · required
timeEnd
​string · date-time · required
pagingLength
​integer · int32 · min: 1 · max: 10000 · required
​IntegrationLogAttributeData[]
sort
​string · enum
Enum values:
asc
desc
Default: desc
pagingStart
​integer · int32 · min: 0
Default: 0

Get integration logs › Responses

The requested report

IntegrationLogReport
​IntegrationLogReportRow[]
POST/reporting/logs/integrations
curl --request POST \ --url https://api.funnelflux.pro/v1/reporting/logs/integrations \ --header 'Content-Type: application/json' \ --data ' { "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "filters": [ { "attribute": "IntegrationID", "whitelistFilters": [ "string" ], "blacklistFilters": [ "string" ] } ], "sort": "desc", "pagingStart": 0, "pagingLength": 1 } '
Example Request Body
{ "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "filters": [ { "attribute": "IntegrationID", "whitelistFilters": [ "string" ], "blacklistFilters": [ "string" ] } ], "sort": "desc", "pagingStart": 0, "pagingLength": 1 }
json
Example Responses
{ "rows": [ { "time": "time", "owner": "owner", "integrationId": "integrationId", "trafficSourceId": "trafficSourceId", "platform": "platform", "intent": "intent", "eventType": "eventType", "eventNumber": 0, "hitId": "hitId", "conversionId": "conversionId", "transactionId": "transactionId", "destinationEvent": "destinationEvent", "requestSummary": "requestSummary", "statusCode": 0, "responseBody": "responseBody", "error": "error", "success": true, "latencyMs": 0, "outcome": "queued", "outcomeReason": "outcomeReason" } ] }
json
application/json

Get integration queue rows

POST
https://api.funnelflux.pro/v1
/reporting/logs/integrations/queue

Returns delayed integration queue rows for the authenticated owner. Read-only. There is no retry, cancel, or delete. Time bounds filter updated_at in UTC. Display timestamps use the timeStart offset. status=completed means the delayed-work row closed. It is not a delivery. statusLabel is Completed, never Delivered. status=held is labeled Held. An expired held row is status=failed with lastError exactly "expired". There is no resolution field. Each row carries transactionId and destinationEvent as strings, empty when unset. The response never includes owner, conversionData, workerId, leaseUntil, or a platform label. lastError is redacted at response time.

Get integration queue rows › Request Body

IntegrationQueueLogParams
timeStart
​string · date-time · required

Inclusive start. Required. Bounds updated_at in UTC.

timeEnd
​string · date-time · required

Inclusive end. Required and must be greater than or equal to timeStart.

pagingLength
​integer · int32 · required

Page size from 1 to 10000. The server fetches one extra row to set metadata.hasMore.

​IntegrationQueueLogAttributeData[]
sort
​string · enum

Order of updated_at, integration_id, and conversion_id. Defaults to desc.

Enum values:
asc
desc
pagingStart
​integer · int32

Get integration queue rows › Responses

The requested queue page. Empty success is rows [] plus metadata, never null.

IntegrationQueueLogReport
​IntegrationQueueLogReportRow[] · required
​IntegrationQueueLogMetadata · required
POST/reporting/logs/integrations/queue
curl --request POST \ --url https://api.funnelflux.pro/v1/reporting/logs/integrations/queue \ --header 'Content-Type: application/json' \ --data ' { "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "filters": [ { "attribute": "IntegrationID", "whitelistFilters": [ "string" ], "blacklistFilters": [ "string" ] } ], "sort": "asc", "pagingStart": 0, "pagingLength": 0 } '
Example Request Body
{ "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "filters": [ { "attribute": "IntegrationID", "whitelistFilters": [ "string" ], "blacklistFilters": [ "string" ] } ], "sort": "asc", "pagingStart": 0, "pagingLength": 0 }
json
Example Responses
{ "rows": [ { "activityTime": "activityTime", "queueId": "queueId", "integrationId": "integrationId", "integrationName": "integrationName", "integrationType": "integrationType", "platform": "platform", "accountId": "accountId", "loginCustomerId": "loginCustomerId", "trafficSourceId": "trafficSourceId", "trafficSourceName": "trafficSourceName", "intent": "intent", "eventType": "eventType", "eventNumber": 0, "hitId": "hitId", "conversionId": "conversionId", "transactionId": "transactionId", "destinationEvent": "destinationEvent", "status": "pending", "statusLabel": "statusLabel", "attempts": 0, "holdReason": "holdReason", "lastError": "lastError", "clickTime": "clickTime", "nextAttemptAt": "nextAttemptAt", "completedAt": "completedAt", "createdAt": "createdAt", "updatedAt": "updatedAt" } ], "metadata": { "rowsReturned": 0, "hasMore": true } }
json
application/json

Get postback log

POST
https://api.funnelflux.pro/v1
/logs/postbacks/

Returns postback log for specified criteria.

Get postback log › Request Body

PostbackLogCriteria
timeStart
​string · date-time · required
timeEnd
​string · date-time · required
idFunnel
​string
Default:
offset
​integer · int32
Default: 0
count
​integer · int32
Default: 100

Get postback log › Responses

The postback log

PostbackLog
total
​integer · int32 · required
​PostbackLogEntry[] · required
POST/logs/postbacks/
curl --request POST \ --url https://api.funnelflux.pro/v1/logs/postbacks \ --header 'Content-Type: application/json' \ --data ' { "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "idFunnel": "", "offset": 0, "count": 100 } '
Example Request Body
{ "timeStart": "2024-08-25T15:00:00Z", "timeEnd": "2024-08-25T15:00:00Z", "idFunnel": "", "offset": 0, "count": 100 }
json
Example Responses
{ "total": 0, "entries": [ { "time": "2024-08-25T15:00:00Z", "url": "url", "idFunnel": "idFunnel", "idTrafficSource": "idTrafficSource", "idHit": "idHit", "idConversion": "idConversion", "idTransaction": "idTransaction", "payout": "payout", "error": "error", "responseStatusCode": 0, "responseBody": "responseBody", "try": 1, "lastTry": true } ] }
json
application/json

UpdatesExplorer