> ## Documentation Index
> Fetch the complete documentation index at: https://developers.everflow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Data Supplement

Creates a new data supplement record. Data supplements allow you to ingest third-party reporting data and merge it with your Everflow reporting.

The request body is a flat object representing the supplement data, including the source integration type, offer/affiliate mapping, tracking parameters, and reporting metrics.

Returns the created supplement record with its assigned ID and timestamps.


## OpenAPI

````yaml openapi/data-supplements.yaml post /networks/supplements
openapi: 3.0.3
info:
  title: Everflow Network API - Data Supplements
  description: >
    Data Supplement endpoints for the Everflow partner marketing platform. Data
    supplements allow you to ingest third-party reporting data (from Appsflyer,
    Adjust, TikTok Ads MBC, Google Ads Cost, and other sources) and merge it
    with your Everflow reporting data. For setup instructions, see the [Data
    Supplement guide](https://helpdesk.everflow.io/customer/data-supplement).
  version: 1.0.0
servers:
  - description: Production Server
    url: https://api.eflow.team/v1
security: []
tags:
  - name: Data Supplements
    description: >-
      Endpoints for creating, reverting, listing, and exporting data supplement
      records.
paths:
  /networks/supplements:
    post:
      tags:
        - Data Supplements
      summary: Create Data Supplement
      requestBody:
        required: true
        content:
          application/json:
            example:
              unix_timestamp: 1709251200
              supplement_source: generic
              network_offer_id: 1
              network_affiliate_id: 7
            schema:
              type: object
              required:
                - unix_timestamp
                - supplement_source
                - network_offer_id
                - network_affiliate_id
              properties:
                unix_timestamp:
                  type: integer
                  description: Unix timestamp for when the supplement data applies.
                supplement_source:
                  type: string
                  description: The third-party source of the supplement data.
                  enum:
                    - appsflyer
                    - adjust
                    - google_ads_cost
                    - tiktok_ads_mbc
                    - generic
                network_offer_id:
                  type: integer
                  description: The Everflow offer ID to associate the supplement data with.
                network_affiliate_id:
                  type: integer
                  description: >-
                    The Everflow affiliate ID to associate the supplement data
                    with.
                source_id:
                  type: string
                  description: Source identifier from the third-party platform.
                sub1:
                  type: string
                  description: Sub-parameter 1 value.
                sub2:
                  type: string
                  description: Sub-parameter 2 value.
                sub3:
                  type: string
                  description: Sub-parameter 3 value.
                sub4:
                  type: string
                  description: Sub-parameter 4 value.
                sub5:
                  type: string
                  description: Sub-parameter 5 value.
                sub6:
                  type: string
                  description: Sub-parameter 6 value.
                sub7:
                  type: string
                  description: Sub-parameter 7 value.
                sub8:
                  type: string
                  description: Sub-parameter 8 value.
                sub9:
                  type: string
                  description: Sub-parameter 9 value.
                sub10:
                  type: string
                  description: Sub-parameter 10 value.
                adv1:
                  type: string
                  description: Advertiser parameter 1 value.
                adv2:
                  type: string
                  description: Advertiser parameter 2 value.
                adv3:
                  type: string
                  description: Advertiser parameter 3 value.
                adv4:
                  type: string
                  description: Advertiser parameter 4 value.
                adv5:
                  type: string
                  description: Advertiser parameter 5 value.
                adv6:
                  type: string
                  description: Advertiser parameter 6 value.
                adv7:
                  type: string
                  description: Advertiser parameter 7 value.
                adv8:
                  type: string
                  description: Advertiser parameter 8 value.
                adv9:
                  type: string
                  description: Advertiser parameter 9 value.
                adv10:
                  type: string
                  description: Advertiser parameter 10 value.
                currency_id:
                  type: string
                  description: Currency code for monetary values (e.g., `USD`).
                reporting:
                  type: object
                  description: >
                    Reporting metrics to associate with this supplement record.
                    These metrics get merged into your Everflow reporting.
                  properties:
                    imp:
                      type: integer
                      description: Impression count.
                    total_click:
                      type: integer
                      description: Total click count.
                    unique_click:
                      type: integer
                      description: Unique click count.
                    invalid_click:
                      type: integer
                      description: Invalid click count.
                    duplicate_click:
                      type: integer
                      description: Duplicate click count.
                    gross_click:
                      type: integer
                      description: Gross click count.
                    cv:
                      type: integer
                      description: Conversion count.
                    total_cv:
                      type: integer
                      description: Total conversions (including scrubbed).
                    invalid_cv_scrub:
                      type: integer
                      description: Invalid/scrubbed conversion count.
                    view_through_cv:
                      type: integer
                      description: View-through conversion count.
                    event:
                      type: integer
                      description: Event count.
                    event_vt:
                      type: integer
                      description: View-through event count.
                    payout:
                      type: number
                      description: Payout amount.
                    revenue:
                      type: number
                      description: Revenue amount.
                    event_revenue:
                      type: number
                      description: Event revenue amount.
                    gross_sales:
                      type: number
                      description: Gross sales amount.
                    gross_sales_vt:
                      type: number
                      description: View-through gross sales.
                    gross_sales_cv:
                      type: number
                      description: Gross sales from conversions.
                    gross_sales_event:
                      type: number
                      description: Gross sales from events.
                    cost:
                      type: number
                      description: Cost amount.
                    media_buying_cost:
                      type: number
                      description: Media buying cost amount.
                    redirect_traffic_revenue:
                      type: number
                      description: Redirect/fallback traffic revenue.
                network_offer_payout_revenue_id:
                  type: integer
                  description: >
                    Optional payout/revenue setting ID to associate with this
                    supplement.
                source_details_json:
                  type: string
                  description: >
                    Raw JSON string containing additional source-specific
                    details.
                relationship:
                  type: object
                  description: >
                    Source-specific relationship data. Include the sub-object
                    matching the `supplement_source` type.
                  properties:
                    appsflyer:
                      type: object
                      description: Appsflyer-specific mapping data.
                      properties:
                        appsflyer_campaign_id:
                          type: string
                        appsflyer_publisher_id:
                          type: string
                        appsflyer_event_id:
                          type: string
                        network_integration_appsflyer_data_import_app_id:
                          type: integer
                    tiktok_ads_mbc:
                      type: object
                      description: TikTok Ads MBC-specific mapping data.
                      properties:
                        network_integration_tiktok_ads_mbc_config_id:
                          type: integer
                        mapping_id:
                          type: string
                        mapping_name:
                          type: string
                        mapping_type:
                          type: string
                        service_type:
                          type: string
                    adjust:
                      type: object
                      description: Adjust-specific mapping data.
                      properties:
                        adjust_campaign_id:
                          type: string
                        adjust_adgroup_id:
                          type: string
                        adjust_creative_id:
                          type: string
                        adjust_partner_id:
                          type: string
                        adjust_event_id:
                          type: string
                        network_integration_adjust_data_import_app_id:
                          type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  network_data_supplement_id:
                    type: integer
                    description: Unique ID of the created supplement record.
                  network_id:
                    type: integer
                    description: Network ID.
                  unix_timestamp:
                    type: integer
                    description: Timestamp the supplement data applies to.
                  supplement_source:
                    type: string
                    description: The source integration type.
                  network_offer_id:
                    type: integer
                  network_affiliate_id:
                    type: integer
                  source_id:
                    type: string
                  currency_id:
                    type: string
                  reporting:
                    type: object
                    description: The reporting metrics.
                  time_created:
                    type: integer
                    example: 1734455015
                    description: Unix timestamp of when the record was created.
      security:
        - API Key: []
components:
  securitySchemes:
    API Key:
      description: The Everflow API key generated from the Control Center > Security.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````