API Reference

Use Cases for Data-In Endpoints

Triple Whale's Data-In API lets you add new data or enhance existing records to keep all your business insights in one place. Use it to:

  • Create New Records: Upload data like ads, orders, products, or surveys from platforms Triple Whale doesn’t integrate with.
  • Enrich Existing Records: Add details like shipping costs or custom tags to data from platforms Triple Whale integrates with.

To check which platforms are supported, visit the integrations page. Below is an overview of the endpoints, their use cases, and workflows:

Supported Endpoints

Creating New Records

1. Ads

  • Use Case: Upload ad data (spend, clicks, impressions) from non-integrated channels.
  • Example Workflow:
    1. Identify ad campaigns missing performance data.
    2. Send a POST request with Channel Name, Campaign ID, and Spend Amount.
    3. View updated metrics like ROAS and CPA.

2. Orders

  • Use Case: Upload orders (customer details, items, totals) from non-integrated platforms.
  • Example Workflow:
    1. Identify orders to add from external platforms.
    2. Send a POST request with Order ID, Customer Details, Line Items, and Transaction Totals.
    3. Metrics like Order Revenue and AOV update automatically.

3. Subscriptions

  • Use Case: Upload subscription data (billing schedules, customers) from non-integrated platforms.
  • Example Workflow:
    1. Collect subscription records to upload.
    2. Send a POST request with Subscription ID, Customer Details, and Subscription Items.
    3. Track metrics like New Subscribers and Churn.

4. Products

  • Use Case: Upload product data (details, variants) from external sources.
  • Example Workflow:
    1. Gather product details to upload.
    2. Send a POST request with Product ID, Product Title, Tags, and Variants.
    3. Analyze product performance trends.

5. Post-Purchase Surveys (PPS)

  • Use Case: Upload survey responses from non-integrated systems.
  • Example Workflow:
    1. Collect survey data linked to orders.
    2. Send a POST request with Order ID, Survey Question, and Customer Response.
    3. Link survey insights to order metrics.

Enriching Existing Records

1. Order Enrichment

  • Use Case: Add data like shipping costs or custom tags to existing orders.
  • Example Workflow:
    1. Find orders missing shipping cost data.
    2. Send a POST request with Shop, Order ID, and Shipping Costs.
    3. View updated metrics like Net Profit and POAS.

Best Practices

  • Check Data Sources: Confirm if the platform is integrated with Triple Whale.
  • Map Fields: Ensure your data matches the API schema.
  • Follow Docs: Refer to API documentation for details and examples.

With the Data-In API, you can centralize your data in Triple Whale and gain better insights to drive your business.