---
title: "Create Derived Event"
method: POST
path: "/derived_events"
---

# Create Derived Event

`POST /derived_events`

## Headers

- `Authorization` string, nullable
- `X-User-Id` string, nullable
- `X-Posthog-Session-Id` string

## Cookies

- `session_id` string, nullable

## Request body

- CreateDerivedEvent
  - `name` string, required
  - `description` string, nullable
  - `event_name` string, required
  - `filters` AllOfWhereFilters, required
    - `all_of` OrWhereFilters[]
      - `or_filters` WhereFilter[]
        - `property` union, required
          - string
          - union
            - RevenueProperty
              - …
            - TaxProperty
              - …
            - DiscountProperty
              - …
            - ShippingProperty
              - …
            - NetRevenueAfterTaxProperty
              - …
            - NetRevenueAfterTaxAndShippingProperty
              - …
            - ProductIDsProperty
              - …
            - VariantIDsProperty
              - …
            - ProductSKUsProperty
              - …
            - ProductNamesProperty
              - …
            - ProductBundleIds
              - …
            - ProductBundleNames
              - …
            - NumberOfItemsProperty
              - …
            - PaymentMethodProperty
              - …
            - SalesChannelTypeProperty
              - …
            - URLProperty
              - …
            - FullURLProperty
              - …
            - ReferrerProperty
              - …
            - LandingURLProperty
              - …
            - FullLandingURLProperty
              - …
            - LandingURLDomainProperty
              - …
            - LandingURLPathProperty
              - …
            - TimezoneProperty
              - …
            - LanguageProperty
              - …
            - TitleProperty
              - …
            - DeviceBrandProperty
              - …
            - DeviceModelProperty
              - …
            - DeviceTypeProperty
              - …
            - OSProperty
              - …
            - BrowserProperty
              - …
            - GenderGuessProperty
              - …
            - GeoIPCityNameProperty
              - …
            - GeoIPCountryNameProperty
              - …
            - GeoIPCountryCodeProperty
              - …
            - GeoIPRegionNameProperty
              - …
            - GeoIPZipCodeProperty
              - …
            - IsCustomerProperty
              - …
            - IsNewVisitorProperty
              - …
            - UtmSourceMedium
              - …
            - FullSessionReferrerProperty
              - …
            - ProfileIDProperty
              - …
            - OrderIDProperty
              - …
            - ProductPriceProperty
              - …
            - ProductQuantityProperty
              - …
            - ProductRevenueProperty
              - …
            - ProductDiscountProperty
              - …
            - ProductTaxesProperty
              - …
            - ProductShippingProperty
              - …
            - ProductNetRevenueProperty
              - …
            - COGSProperty
              - …
            - GrossProfitProperty
              - …
            - PaymentProcessingFeeProperty
              - …
            - ShippingCostProperty
              - …
            - GrossRevenueProperty
              - …
            - ContributionProfitProperty
              - …
        - `operator` '=' | '>' | '<' | '>=' | '<=' | '!=' | 'includes' | 'includes_any_contains' | 'not_includes' | 'contains' | 'not_contains' | 'is_set' | 'is_not_set', required
        - `value` union, required
          - boolean
          - integer
          - number
          - string
          - string[]

## Response `200`

Successful Response

- DerivedEventSchema
  - `id` integer, required
  - `name` string, required
  - `description` string, nullable
  - `event_name` string, required
  - `filters` AllOfWhereFilters, required
    - `all_of` OrWhereFilters[]
      - `or_filters` WhereFilter[]
        - `property` union, required
          - string
          - union
            - RevenueProperty
              - …
            - TaxProperty
              - …
            - DiscountProperty
              - …
            - ShippingProperty
              - …
            - NetRevenueAfterTaxProperty
              - …
            - NetRevenueAfterTaxAndShippingProperty
              - …
            - ProductIDsProperty
              - …
            - VariantIDsProperty
              - …
            - ProductSKUsProperty
              - …
            - ProductNamesProperty
              - …
            - ProductBundleIds
              - …
            - ProductBundleNames
              - …
            - NumberOfItemsProperty
              - …
            - PaymentMethodProperty
              - …
            - SalesChannelTypeProperty
              - …
            - URLProperty
              - …
            - FullURLProperty
              - …
            - ReferrerProperty
              - …
            - LandingURLProperty
              - …
            - FullLandingURLProperty
              - …
            - LandingURLDomainProperty
              - …
            - LandingURLPathProperty
              - …
            - TimezoneProperty
              - …
            - LanguageProperty
              - …
            - TitleProperty
              - …
            - DeviceBrandProperty
              - …
            - DeviceModelProperty
              - …
            - DeviceTypeProperty
              - …
            - OSProperty
              - …
            - BrowserProperty
              - …
            - GenderGuessProperty
              - …
            - GeoIPCityNameProperty
              - …
            - GeoIPCountryNameProperty
              - …
            - GeoIPCountryCodeProperty
              - …
            - GeoIPRegionNameProperty
              - …
            - GeoIPZipCodeProperty
              - …
            - IsCustomerProperty
              - …
            - IsNewVisitorProperty
              - …
            - UtmSourceMedium
              - …
            - FullSessionReferrerProperty
              - …
            - ProfileIDProperty
              - …
            - OrderIDProperty
              - …
            - ProductPriceProperty
              - …
            - ProductQuantityProperty
              - …
            - ProductRevenueProperty
              - …
            - ProductDiscountProperty
              - …
            - ProductTaxesProperty
              - …
            - ProductShippingProperty
              - …
            - ProductNetRevenueProperty
              - …
            - COGSProperty
              - …
            - GrossProfitProperty
              - …
            - PaymentProcessingFeeProperty
              - …
            - ShippingCostProperty
              - …
            - GrossRevenueProperty
              - …
            - ContributionProfitProperty
              - …
        - `operator` '=' | '>' | '<' | '>=' | '<=' | '!=' | 'includes' | 'includes_any_contains' | 'not_includes' | 'contains' | 'not_contains' | 'is_set' | 'is_not_set', required
        - `value` union, required
          - boolean
          - integer
          - number
          - string
          - string[]
  - `creator` AccountSchema
    - `id` integer, required
    - `email` string, required
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `profile_picture_url` string, nullable
  - `created_at` string, date-time, nullable
  - `is_editable` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/runconverge/apis/fastapi.md) · [All operations](https://skmtc.dev/runconverge/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runconverge/fastapi/revisions/1452e350bd1d/schema)