whop_sdk 0.0.37 → 0.0.39

data/lib/whop_sdk/resources/ad_campaigns.rb

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Resources
+    # Ad campaigns
+    class AdCampaigns
+      # Retrieves a single ad campaign by its unique identifier.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:basic:read`
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] The unique identifier of the ad campaign.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdCampaignRetrieveResponse]
+      #
+      # @see WhopSDK::Models::AdCampaignRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["ad_campaigns/%1$s", id],
+          model: WhopSDK::Models::AdCampaignRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::AdCampaignUpdateParams} for more details.
+      #
+      # Updates an ad campaign synchronously.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:update`
+      #
+      # @overload update(id, budget: nil, request_options: {})
+      #
+      # @param id [String] The unique identifier of the ad campaign to update.
+      #
+      # @param budget [Float, nil] The campaign budget in dollars. The interpretation (daily or lifetime) follows t
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdCampaignUpdateResponse]
+      #
+      # @see WhopSDK::Models::AdCampaignUpdateParams
+      def update(id, params = {})
+        parsed, options = WhopSDK::AdCampaignUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["ad_campaigns/%1$s", id],
+          body: parsed,
+          model: WhopSDK::Models::AdCampaignUpdateResponse,
+          options: options
+        )
+      end
+
+      # Returns a paginated list of ad campaigns for a company, with optional filtering
+      # by status, and creation date.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:basic:read`
+      #
+      # @overload list(company_id:, after: nil, before: nil, created_after: nil, created_before: nil, first: nil, last: nil, query: nil, status: nil, request_options: {})
+      #
+      # @param company_id [String] The unique identifier of the company to list ad campaigns for.
+      #
+      # @param after [String, nil] Returns the elements in the list that come after the specified cursor.
+      #
+      # @param before [String, nil] Returns the elements in the list that come before the specified cursor.
+      #
+      # @param created_after [Time, nil] Only return ad campaigns created after this timestamp.
+      #
+      # @param created_before [Time, nil] Only return ad campaigns created before this timestamp.
+      #
+      # @param first [Integer, nil] Returns the first _n_ elements from the list.
+      #
+      # @param last [Integer, nil] Returns the last _n_ elements from the list.
+      #
+      # @param query [String, nil] Case-insensitive substring match against the campaign title.
+      #
+      # @param status [Symbol, WhopSDK::Models::AdCampaignListParams::Status, nil] The status of an ad campaign.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Internal::CursorPage<WhopSDK::Models::AdCampaignListResponse>]
+      #
+      # @see WhopSDK::Models::AdCampaignListParams
+      def list(params)
+        parsed, options = WhopSDK::AdCampaignListParams.dump_request(params)
+        query = WhopSDK::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "ad_campaigns",
+          query: query,
+          page: WhopSDK::Internal::CursorPage,
+          model: WhopSDK::Models::AdCampaignListResponse,
+          options: options
+        )
+      end
+
+      # Pauses an ad campaign, optionally until a specific date.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:update`
+      #
+      # @overload pause(id, request_options: {})
+      #
+      # @param id [String] The unique identifier of the ad campaign to pause.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdCampaignPauseResponse]
+      #
+      # @see WhopSDK::Models::AdCampaignPauseParams
+      def pause(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["ad_campaigns/%1$s/pause", id],
+          model: WhopSDK::Models::AdCampaignPauseResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Resumes a paused ad campaign.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:update`
+      #
+      # @overload unpause(id, request_options: {})
+      #
+      # @param id [String] The unique identifier of the ad campaign to unpause.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdCampaignUnpauseResponse]
+      #
+      # @see WhopSDK::Models::AdCampaignUnpauseParams
+      def unpause(id, params = {})
+        @client.request(
+          method: :post,
+          path: ["ad_campaigns/%1$s/unpause", id],
+          model: WhopSDK::Models::AdCampaignUnpauseResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [WhopSDK::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/whop_sdk/resources/ad_groups.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Resources
+    # Ad groups
+    class AdGroups
+      # Retrieves a single ad group by its unique identifier.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:basic:read`
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] The unique identifier of the ad group.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdGroupRetrieveResponse]
+      #
+      # @see WhopSDK::Models::AdGroupRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["ad_groups/%1$s", id],
+          model: WhopSDK::Models::AdGroupRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Updates an existing ad group.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:update`
+      # - `ad_campaign:basic:read`
+      #
+      # @overload update(id, budget: nil, budget_type: nil, config: nil, daily_budget: nil, name: nil, platform_config: nil, status: nil, request_options: {})
+      #
+      # @param id [String] The unique identifier of the ad group to update.
+      #
+      # @param budget [Float, nil] Budget amount in dollars.
+      #
+      # @param budget_type [Symbol, WhopSDK::Models::AdGroupUpdateParams::BudgetType, nil] The budget type for an ad campaign or ad group.
+      #
+      # @param config [WhopSDK::Models::AdGroupUpdateParams::Config, nil] Unified ad group configuration (bidding, optimization, targeting).
+      #
+      # @param daily_budget [Float, nil] Daily budget in dollars.
+      #
+      # @param name [String, nil] Human-readable ad group name.
+      #
+      # @param platform_config [WhopSDK::Models::AdGroupUpdateParams::PlatformConfig, nil] Platform-specific ad group configuration.
+      #
+      # @param status [Symbol, WhopSDK::Models::AdGroupUpdateParams::Status, nil] The status of an external ad group.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdGroupUpdateResponse]
+      #
+      # @see WhopSDK::Models::AdGroupUpdateParams
+      def update(id, params = {})
+        parsed, options = WhopSDK::AdGroupUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["ad_groups/%1$s", id],
+          body: parsed,
+          model: WhopSDK::Models::AdGroupUpdateResponse,
+          options: options
+        )
+      end
+
+      # Returns a paginated list of ad groups scoped by campaign or company, with
+      # optional filtering by status and creation date.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:basic:read`
+      #
+      # @overload list(after: nil, before: nil, campaign_id: nil, company_id: nil, created_after: nil, created_before: nil, first: nil, last: nil, query: nil, status: nil, request_options: {})
+      #
+      # @param after [String, nil] Returns the elements in the list that come after the specified cursor.
+      #
+      # @param before [String, nil] Returns the elements in the list that come before the specified cursor.
+      #
+      # @param campaign_id [String, nil] Filter by campaign. Provide exactly one of campaign_id or company_id.
+      #
+      # @param company_id [String, nil] Filter by company. Provide exactly one of campaign_id or company_id.
+      #
+      # @param created_after [Time, nil] Only return ad groups created after this timestamp.
+      #
+      # @param created_before [Time, nil] Only return ad groups created before this timestamp.
+      #
+      # @param first [Integer, nil] Returns the first _n_ elements from the list.
+      #
+      # @param last [Integer, nil] Returns the last _n_ elements from the list.
+      #
+      # @param query [String, nil] Case-insensitive substring match against the ad group name.
+      #
+      # @param status [Symbol, WhopSDK::Models::AdGroupListParams::Status, nil] The status of an external ad group.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Internal::CursorPage<WhopSDK::Models::AdGroupListResponse>]
+      #
+      # @see WhopSDK::Models::AdGroupListParams
+      def list(params = {})
+        parsed, options = WhopSDK::AdGroupListParams.dump_request(params)
+        query = WhopSDK::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "ad_groups",
+          query: query,
+          page: WhopSDK::Internal::CursorPage,
+          model: WhopSDK::Models::AdGroupListResponse,
+          options: options
+        )
+      end
+
+      # Soft-deletes an ad group.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:update`
+      #
+      # @overload delete(id, request_options: {})
+      #
+      # @param id [String] The unique identifier of the ad group to delete.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Boolean]
+      #
+      # @see WhopSDK::Models::AdGroupDeleteParams
+      def delete(id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["ad_groups/%1$s", id],
+          model: WhopSDK::Internal::Type::Boolean,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [WhopSDK::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/whop_sdk/resources/ad_reports.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Resources
+    # Ad reports
+    class AdReports
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::AdReportRetrieveParams} for more details.
+      #
+      # Performance report for an ad campaign, ad group, or ad. Returns aggregate totals
+      # and an optional per-day breakdown. Exactly one of `adCampaignId`, `adGroupId`,
+      # or `adId` must be provided.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:stats:read`
+      #
+      # @overload retrieve(from:, to:, ad_campaign_id: nil, ad_group_id: nil, ad_id: nil, currency: nil, include_daily: nil, request_options: {})
+      #
+      # @param from [Time] Inclusive start of the reporting window.
+      #
+      # @param to [Time] Inclusive end of the reporting window.
+      #
+      # @param ad_campaign_id [String, nil] The unique identifier of an ad campaign. Mutually exclusive with `adGroupId` and
+      #
+      # @param ad_group_id [String, nil] The unique identifier of an ad group. Mutually exclusive with `adCampaignId` and
+      #
+      # @param ad_id [String, nil] The unique identifier of an ad. Mutually exclusive with `adCampaignId` and `adGr
+      #
+      # @param currency [String, nil] ISO 4217 currency code to report `spend` in. Defaults to the company's ads repor
+      #
+      # @param include_daily [Boolean, nil] When true, includes a per-day breakdown alongside the summary.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdReportRetrieveResponse]
+      #
+      # @see WhopSDK::Models::AdReportRetrieveParams
+      def retrieve(params)
+        parsed, options = WhopSDK::AdReportRetrieveParams.dump_request(params)
+        query = WhopSDK::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "ad_reports",
+          query: query,
+          model: WhopSDK::Models::AdReportRetrieveResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [WhopSDK::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/whop_sdk/resources/ads.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Resources
+    # Ads
+    class Ads
+      # Retrieve an ad by its unique identifier.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:basic:read`
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] The unique identifier of the ad.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::AdRetrieveResponse]
+      #
+      # @see WhopSDK::Models::AdRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["ads/%1$s", id],
+          model: WhopSDK::Models::AdRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::AdListParams} for more details.
+      #
+      # List ads scoped by ad group, campaign, or company.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:basic:read`
+      #
+      # @overload list(ad_group_id: nil, after: nil, before: nil, campaign_id: nil, company_id: nil, created_after: nil, created_before: nil, first: nil, last: nil, status: nil, request_options: {})
+      #
+      # @param ad_group_id [String, nil] Filter by ad group. Provide exactly one of ad*group_id, campaign_id, or company*
+      #
+      # @param after [String, nil] Returns the elements in the list that come after the specified cursor.
+      #
+      # @param before [String, nil] Returns the elements in the list that come before the specified cursor.
+      #
+      # @param campaign_id [String, nil] Filter by campaign. Provide exactly one of ad*group_id, campaign_id, or company*
+      #
+      # @param company_id [String, nil] Filter by company. Provide exactly one of ad_group_id, campaign_id, or company_i
+      #
+      # @param created_after [Time, nil] Only return ads created after this timestamp.
+      #
+      # @param created_before [Time, nil] Only return ads created before this timestamp.
+      #
+      # @param first [Integer, nil] Returns the first _n_ elements from the list.
+      #
+      # @param last [Integer, nil] Returns the last _n_ elements from the list.
+      #
+      # @param status [Symbol, WhopSDK::Models::AdListParams::Status, nil] The status of an external ad.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Internal::CursorPage<WhopSDK::Models::AdListResponse>]
+      #
+      # @see WhopSDK::Models::AdListParams
+      def list(params = {})
+        parsed, options = WhopSDK::AdListParams.dump_request(params)
+        query = WhopSDK::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "ads",
+          query: query,
+          page: WhopSDK::Internal::CursorPage,
+          model: WhopSDK::Models::AdListResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [WhopSDK::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/whop_sdk/resources/bounties.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Resources
+    # Bounties
+    class Bounties
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::BountyCreateParams} for more details.
+      #
+      # Create a new workforce bounty by funding a dedicated bounty pool.
+      #
+      # Required permissions:
+      #
+      # - `bounty:create`
+      #
+      # @overload create(base_unit_amount:, currency:, description:, title:, accepted_submissions_limit: nil, allowed_country_codes: nil, experience_id: nil, origin_account_id: nil, post_markdown_content: nil, post_title: nil, request_options: {})
+      #
+      # @param base_unit_amount [Float] The amount paid to each approved submission. The total bounty pool funded is thi
+      #
+      # @param currency [Symbol, WhopSDK::Models::Currency] The currency for the bounty pool funding amount.
+      #
+      # @param description [String] The description of the bounty.
+      #
+      # @param title [String] The title of the bounty.
+      #
+      # @param accepted_submissions_limit [Integer, nil] The number of submissions that can be approved before the bounty closes. Default
+      #
+      # @param allowed_country_codes [Array<String>, nil] The ISO3166 country codes where this bounty should be visible. Empty means globa
+      #
+      # @param experience_id [String, nil] An optional experience to scope the bounty to.
+      #
+      # @param origin_account_id [String, nil] The user (user*\*) or company (biz*\*) tag whose balance funds this bounty pool.
+      # D
+      #
+      # @param post_markdown_content [String, nil] Optional markdown body for the anchor forum post. Falls back to the bounty descr
+      #
+      # @param post_title [String, nil] Optional title for the anchor forum post. Falls back to the bounty title when om
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::BountyCreateResponse]
+      #
+      # @see WhopSDK::Models::BountyCreateParams
+      def create(params)
+        parsed, options = WhopSDK::BountyCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "bounties",
+          body: parsed,
+          model: WhopSDK::Models::BountyCreateResponse,
+          options: options
+        )
+      end
+
+      # Retrieves a workforce bounty for the current authenticated user.
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] The unique identifier of the workforce bounty to retrieve.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::BountyRetrieveResponse]
+      #
+      # @see WhopSDK::Models::BountyRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["bounties/%1$s", id],
+          model: WhopSDK::Models::BountyRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::BountyListParams} for more details.
+      #
+      # Returns a paginated list of workforce bounties. When experienceId is provided,
+      # returns bounties scoped to that experience. When omitted, returns bounties with
+      # no experience.
+      #
+      # @overload list(after: nil, before: nil, direction: nil, experience_id: nil, first: nil, last: nil, status: nil, request_options: {})
+      #
+      # @param after [String, nil] Returns the elements in the list that come after the specified cursor.
+      #
+      # @param before [String, nil] Returns the elements in the list that come before the specified cursor.
+      #
+      # @param direction [Symbol, WhopSDK::Models::Direction, nil] The direction of the sort.
+      #
+      # @param experience_id [String, nil] The experience to list bounties for. When omitted, returns bounties with no expe
+      #
+      # @param first [Integer, nil] Returns the first _n_ elements from the list.
+      #
+      # @param last [Integer, nil] Returns the last _n_ elements from the list.
+      #
+      # @param status [Symbol, WhopSDK::Models::BountyListParams::Status, nil] The available bounty statuses to choose from.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Internal::CursorPage<WhopSDK::Models::BountyListResponse>]
+      #
+      # @see WhopSDK::Models::BountyListParams
+      def list(params = {})
+        parsed, options = WhopSDK::BountyListParams.dump_request(params)
+        query = WhopSDK::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "bounties",
+          query: query,
+          page: WhopSDK::Internal::CursorPage,
+          model: WhopSDK::Models::BountyListResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [WhopSDK::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/whop_sdk/resources/companies.rb

@@ -170,6 +170,40 @@ module WhopSDK
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {WhopSDK::Models::CompanyCreateAPIKeyParams} for more details.
+      #
+      # Create an API key for a connected account (child company) owned by a parent
+      # company.
+      #
+      # @overload create_api_key(parent_company_id, child_company_id:, name: nil, permissions: nil, role: nil, request_options: {})
+      #
+      # @param parent_company_id [String] The unique identifier of the parent platform company (e.g. 'biz_xxx').
+      #
+      # @param child_company_id [String] The unique identifier of the connected account to create the API key for (e.g. '
+      #
+      # @param name [String, nil] A human-readable name for the API key, such as 'Production API Key'.
+      #
+      # @param permissions [Array<WhopSDK::Models::CompanyCreateAPIKeyParams::Permission>, nil] Granular permission statements defining which actions this API key can perform.
+      #
+      # @param role [Symbol, WhopSDK::Models::CompanyCreateAPIKeyParams::Role, nil] The different system roles that can be assigned.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::CompanyCreateAPIKeyResponse]
+      #
+      # @see WhopSDK::Models::CompanyCreateAPIKeyParams
+      def create_api_key(parent_company_id, params)
+        parsed, options = WhopSDK::CompanyCreateAPIKeyParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["companies/%1$s/api_keys", parent_company_id],
+          body: parsed,
+          model: WhopSDK::Models::CompanyCreateAPIKeyResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [WhopSDK::Client]

data/lib/whop_sdk/resources/conversions.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Resources
+    # Conversions
+    class Conversions
+      # Track a conversion or engagement event for a company.
+      #
+      # Required permissions:
+      #
+      # - `event:create`
+      #
+      # @overload create(company_id:, event_name:, action_source: nil, context: nil, currency: nil, custom_name: nil, event_id: nil, event_time: nil, plan_id: nil, product_id: nil, referrer_url: nil, url: nil, user: nil, value: nil, request_options: {})
+      #
+      # @param company_id [String] The company to associate with this event.
+      #
+      # @param event_name [Symbol, WhopSDK::Models::ConversionCreateParams::EventName] The type of event.
+      #
+      # @param action_source [Symbol, WhopSDK::Models::ConversionCreateParams::ActionSource, nil] The channel where an event originated
+      #
+      # @param context [WhopSDK::Models::ConversionCreateParams::Context, nil] Tracking and attribution context.
+      #
+      # @param currency [Symbol, WhopSDK::Models::Currency, nil] The available currencies on the platform
+      #
+      # @param custom_name [String, nil] Custom event name when event_name is 'custom'.
+      #
+      # @param event_id [String, nil] Client-provided identifier for deduplication. Generated if omitted.
+      #
+      # @param event_time [Time, nil] When the event occurred. Defaults to now.
+      #
+      # @param plan_id [String, nil] The plan associated with the event.
+      #
+      # @param product_id [String, nil] The product associated with the event.
+      #
+      # @param referrer_url [String, nil] The referring URL.
+      #
+      # @param url [String, nil] The URL where the event occurred.
+      #
+      # @param user [WhopSDK::Models::ConversionCreateParams::User, nil] User identity and profile data.
+      #
+      # @param value [Float, nil] Monetary value associated with the event.
+      #
+      # @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [WhopSDK::Models::ConversionCreateResponse]
+      #
+      # @see WhopSDK::Models::ConversionCreateParams
+      def create(params)
+        parsed, options = WhopSDK::ConversionCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "conversions",
+          body: parsed,
+          model: WhopSDK::Models::ConversionCreateResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [WhopSDK::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end