Widgets

Create Widgets

Changed on

Batch create widgets via upsert.

post/v1/widgets

Request

  • Base URL: https://api.oviond.com
  • URL: https://api.oviond.com/v1/widgets
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Request body

source_type'project' | 'template' required
source_idstring required
client_idstring required
page_idstring required
account_idstring

Example request

{
  "widgets": [
    {
      "filters": [
        {
          "field": "sessionMedium",
          "operator": "contains"
        }
      ],
      "currency": {
        "code": "USD",
        "symbol": "$",
        "iso": "US"
      },
      "date_range": {
        "text": "Last 30 Days",
        "compare": "None",
        "current_start": "2026-03-01",
        "current_end": "2026-03-31",
        "previous_start": "2026-02-01",
        "previous_end": "2026-02-28",
        "custom_days": 60,
        "custom_months": 3
      }
    }
  ],
  "source_type": "project",
  "source_id": "proj123"
}

Response

Widgets created

successtrue required

Changes

  • 4cb0a07daf41Revision changes
    • breaking

      removed the enum value amazon-advertising of the request property //