COconversion

Export Touchpoints

Bulk, incremental export of Mosaic touchpoints, computed under your attribution settings and ordered by when they occurred. Requires Mosaic in addition to export access.

Send occurredAt on the first call, then pass pagination.nextCursor back as cursor until it is null or stops changing. Without occurredAt.end, the export stops a day before now so sessions and email clicks settle first. Persist the last cursor between syncs to resume.

Request access. This endpoint is not enabled by default, contact the Conversion team to request access. Calls from accounts without it return 403 export_not_enabled.

post/v2/exports/touchpoints

Request

  • Base URL
    https://pub-api.conversion.ai/api
  • Auth
    • API key in header X-API-Key
    • or API key in query parameter api_key

Request body

cursorstring

The opaque cursor returned as pagination.nextCursor by a previous call. Omit it on the first page. Send it without filters, because the cursor carries them; sending both returns invalid_filter.

limitinteger

The maximum number of rows per page. Defaults to 1000. Values are clamped to [1, 5000].

Example request

{
  "cursor": "eyJ2IjoxLCJmIjp7fSwiayI6ImFiYyJ9"
}

Response

A page of touchpoints retrieved successfully.

Example response

{
  "data": {
    "touchpoints": [
      {
        "touchpointId": "ws:3f2b6c1e-8d4a-4f7e-9a1b-2c3d4e5f6a7b:9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
      }
    ]
  }
}

Changes

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