Overview

Provider configuration endpoints allow you to discover available resources from your connected third-party platforms. These endpoints query the actual third-party APIs in real-time to list resources like S3 buckets, Salesforce objects, SendGrid lists, Facebook custom audiences, etc.

These endpoints are primarily used by the Lytics UI when configuring integrations and workflows. They can also be used programmatically to discover available resources before creating export or import configurations.

📘

All provider endpoints require a valid auth_id query parameter referencing an existing authorization for that provider.

Common Pattern

All provider endpoints follow a consistent pattern:

GET /v2/provider/{provider}/{resource_type}?auth_id={auth_id}

Response format: An array of [id, display_name] tuples:

[
  ["resource_id_1", "Resource Display Name 1"],
  ["resource_id_2", "Resource Display Name 2"]
]

Some providers support hierarchical navigation where you pass additional query parameters to drill down into nested resources (e.g., BigQuery project -> dataset -> table -> field).

Available Providers

AWS

Google

Azure

Snowflake

Salesforce

Facebook

LinkedIn

Email Marketing

All follow the pattern GET /v2/provider/{provider}/{resource}.

Other Advertising

Other

Example: Hierarchical Discovery

Some providers support hierarchical navigation. For example, to configure a BigQuery export:

# Step 1: List available projects
GET /v2/provider/google/bigquery?auth_id=auth_xyz

# Step 2: List datasets in a project
GET /v2/provider/google/bigquery?auth_id=auth_xyz&type=dataset&project=my-project

# Step 3: List tables in a dataset
GET /v2/provider/google/bigquery?auth_id=auth_xyz&type=table&project=my-project&dataset=my_dataset

# Step 4: List fields in a table
GET /v2/provider/google/bigquery?auth_id=auth_xyz&type=field&project=my-project&dataset=my_dataset&table=my_table