whop_sdk 0.0.39 → 0.0.41

data/lib/whop_sdk/models/refund_retrieve_response.rb

@@ -138,10 +138,10 @@ module WhopSDK
         required :created_at, Time
 
         # @!attribute currency
-        #   The available currencies on the platform
+        #   The three-letter ISO currency code for this payment (e.g., 'usd', 'eur').
         #
-        #   @return [Symbol, WhopSDK::Models::Currency, nil]
-        required :currency, enum: -> { WhopSDK::Currency }, nil?: true
+        #   @return [Symbol, WhopSDK::Models::Currency]
+        required :currency, enum: -> { WhopSDK::Currency }
 
         # @!attribute dispute_alerted_at
         #   When an alert came in that this transaction will be disputed
@@ -161,6 +161,13 @@ module WhopSDK
         #   @return [WhopSDK::Models::RefundRetrieveResponse::Payment::Membership, nil]
         required :membership, -> { WhopSDK::Models::RefundRetrieveResponse::Payment::Membership }, nil?: true
 
+        # @!attribute metadata
+        #   The custom metadata stored on this payment. This will be copied over to the
+        #   checkout configuration for which this payment was made
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        required :metadata, WhopSDK::Internal::Type::HashOf[WhopSDK::Internal::Type::Unknown], nil?: true
+
         # @!attribute paid_at
         #   The time at which this payment was successfully collected. Null if the payment
         #   has not yet succeeded. As a Unix timestamp.
@@ -174,6 +181,18 @@ module WhopSDK
         #   @return [Symbol, WhopSDK::Models::PaymentMethodTypes, nil]
         required :payment_method_type, enum: -> { WhopSDK::PaymentMethodTypes }, nil?: true
 
+        # @!attribute plan
+        #   The plan attached to this payment.
+        #
+        #   @return [WhopSDK::Models::RefundRetrieveResponse::Payment::Plan, nil]
+        required :plan, -> { WhopSDK::Models::RefundRetrieveResponse::Payment::Plan }, nil?: true
+
+        # @!attribute product
+        #   The product this payment was made for
+        #
+        #   @return [WhopSDK::Models::RefundRetrieveResponse::Payment::Product, nil]
+        required :product, -> { WhopSDK::Models::RefundRetrieveResponse::Payment::Product }, nil?: true
+
         # @!attribute subtotal
         #   The subtotal to show to the creator (excluding buyer fees).
         #
@@ -217,7 +236,7 @@ module WhopSDK
         #   @return [WhopSDK::Models::RefundRetrieveResponse::Payment::User, nil]
         required :user, -> { WhopSDK::Models::RefundRetrieveResponse::Payment::User }, nil?: true
 
-        # @!method initialize(id:, billing_reason:, card_brand:, card_last4:, created_at:, currency:, dispute_alerted_at:, member:, membership:, paid_at:, payment_method_type:, subtotal:, tax_amount:, tax_behavior:, tax_refunded_amount:, total:, usd_total:, user:)
+        # @!method initialize(id:, billing_reason:, card_brand:, card_last4:, created_at:, currency:, dispute_alerted_at:, member:, membership:, metadata:, paid_at:, payment_method_type:, plan:, product:, subtotal:, tax_amount:, tax_behavior:, tax_refunded_amount:, total:, usd_total:, user:)
         #   Some parameter documentations has been truncated, see
         #   {WhopSDK::Models::RefundRetrieveResponse::Payment} for more details.
         #
@@ -234,7 +253,7 @@ module WhopSDK
         #
         #   @param created_at [Time] The datetime the payment was created.
         #
-        #   @param currency [Symbol, WhopSDK::Models::Currency, nil] The available currencies on the platform
+        #   @param currency [Symbol, WhopSDK::Models::Currency] The three-letter ISO currency code for this payment (e.g., 'usd', 'eur').
         #
         #   @param dispute_alerted_at [Time, nil] When an alert came in that this transaction will be disputed
         #
@@ -242,10 +261,16 @@ module WhopSDK
         #
         #   @param membership [WhopSDK::Models::RefundRetrieveResponse::Payment::Membership, nil] The membership attached to this payment.
         #
+        #   @param metadata [Hash{Symbol=>Object}, nil] The custom metadata stored on this payment. This will be copied over to the chec
+        #
         #   @param paid_at [Time, nil] The time at which this payment was successfully collected. Null if the payment h
         #
         #   @param payment_method_type [Symbol, WhopSDK::Models::PaymentMethodTypes, nil] The different types of payment methods that can be used.
         #
+        #   @param plan [WhopSDK::Models::RefundRetrieveResponse::Payment::Plan, nil] The plan attached to this payment.
+        #
+        #   @param product [WhopSDK::Models::RefundRetrieveResponse::Payment::Product, nil] The product this payment was made for
+        #
         #   @param subtotal [Float, nil] The subtotal to show to the creator (excluding buyer fees).
         #
         #   @param tax_amount [Float, nil] The calculated amount of the sales/VAT tax (if applicable).
@@ -304,6 +329,60 @@ module WhopSDK
           #   @param status [Symbol, WhopSDK::Models::MembershipStatus] The state of the membership.
         end
 
+        # @see WhopSDK::Models::RefundRetrieveResponse::Payment#plan
+        class Plan < WhopSDK::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique identifier for the plan.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute metadata
+          #   Custom key-value pairs stored on the plan. Included in webhook payloads for
+          #   payment and membership events. Max 50 keys, 100 chars per key, 500 chars per
+          #   string value.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          required :metadata, WhopSDK::Internal::Type::HashOf[WhopSDK::Internal::Type::Unknown], nil?: true
+
+          # @!method initialize(id:, metadata:)
+          #   Some parameter documentations has been truncated, see
+          #   {WhopSDK::Models::RefundRetrieveResponse::Payment::Plan} for more details.
+          #
+          #   The plan attached to this payment.
+          #
+          #   @param id [String] The unique identifier for the plan.
+          #
+          #   @param metadata [Hash{Symbol=>Object}, nil] Custom key-value pairs stored on the plan. Included in webhook payloads for paym
+        end
+
+        # @see WhopSDK::Models::RefundRetrieveResponse::Payment#product
+        class Product < WhopSDK::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique identifier for the product.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute metadata
+          #   Custom key-value pairs stored on the product and included in payment and
+          #   membership webhook payloads. Max 50 keys, 100 characters per key, 500 characters
+          #   per string value.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          required :metadata, WhopSDK::Internal::Type::HashOf[WhopSDK::Internal::Type::Unknown], nil?: true
+
+          # @!method initialize(id:, metadata:)
+          #   Some parameter documentations has been truncated, see
+          #   {WhopSDK::Models::RefundRetrieveResponse::Payment::Product} for more details.
+          #
+          #   The product this payment was made for
+          #
+          #   @param id [String] The unique identifier for the product.
+          #
+          #   @param metadata [Hash{Symbol=>Object}, nil] Custom key-value pairs stored on the product and included in payment and members
+        end
+
         # @see WhopSDK::Models::RefundRetrieveResponse::Payment#user
         class User < WhopSDK::Internal::Type::BaseModel
           # @!attribute id

data/lib/whop_sdk/models/refund_updated_webhook_event.rb

@@ -192,10 +192,10 @@ module WhopSDK
           required :created_at, Time
 
           # @!attribute currency
-          #   The available currencies on the platform
+          #   The three-letter ISO currency code for this payment (e.g., 'usd', 'eur').
           #
-          #   @return [Symbol, WhopSDK::Models::Currency, nil]
-          required :currency, enum: -> { WhopSDK::Currency }, nil?: true
+          #   @return [Symbol, WhopSDK::Models::Currency]
+          required :currency, enum: -> { WhopSDK::Currency }
 
           # @!attribute dispute_alerted_at
           #   When an alert came in that this transaction will be disputed
@@ -219,6 +219,13 @@ module WhopSDK
                    },
                    nil?: true
 
+          # @!attribute metadata
+          #   The custom metadata stored on this payment. This will be copied over to the
+          #   checkout configuration for which this payment was made
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          required :metadata, WhopSDK::Internal::Type::HashOf[WhopSDK::Internal::Type::Unknown], nil?: true
+
           # @!attribute paid_at
           #   The time at which this payment was successfully collected. Null if the payment
           #   has not yet succeeded. As a Unix timestamp.
@@ -232,6 +239,18 @@ module WhopSDK
           #   @return [Symbol, WhopSDK::Models::PaymentMethodTypes, nil]
           required :payment_method_type, enum: -> { WhopSDK::PaymentMethodTypes }, nil?: true
 
+          # @!attribute plan
+          #   The plan attached to this payment.
+          #
+          #   @return [WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment::Plan, nil]
+          required :plan, -> { WhopSDK::RefundUpdatedWebhookEvent::Data::Payment::Plan }, nil?: true
+
+          # @!attribute product
+          #   The product this payment was made for
+          #
+          #   @return [WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment::Product, nil]
+          required :product, -> { WhopSDK::RefundUpdatedWebhookEvent::Data::Payment::Product }, nil?: true
+
           # @!attribute subtotal
           #   The subtotal to show to the creator (excluding buyer fees).
           #
@@ -275,7 +294,7 @@ module WhopSDK
           #   @return [WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment::User, nil]
           required :user, -> { WhopSDK::RefundUpdatedWebhookEvent::Data::Payment::User }, nil?: true
 
-          # @!method initialize(id:, billing_reason:, card_brand:, card_last4:, created_at:, currency:, dispute_alerted_at:, member:, membership:, paid_at:, payment_method_type:, subtotal:, tax_amount:, tax_behavior:, tax_refunded_amount:, total:, usd_total:, user:)
+          # @!method initialize(id:, billing_reason:, card_brand:, card_last4:, created_at:, currency:, dispute_alerted_at:, member:, membership:, metadata:, paid_at:, payment_method_type:, plan:, product:, subtotal:, tax_amount:, tax_behavior:, tax_refunded_amount:, total:, usd_total:, user:)
           #   Some parameter documentations has been truncated, see
           #   {WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment} for more details.
           #
@@ -292,7 +311,7 @@ module WhopSDK
           #
           #   @param created_at [Time] The datetime the payment was created.
           #
-          #   @param currency [Symbol, WhopSDK::Models::Currency, nil] The available currencies on the platform
+          #   @param currency [Symbol, WhopSDK::Models::Currency] The three-letter ISO currency code for this payment (e.g., 'usd', 'eur').
           #
           #   @param dispute_alerted_at [Time, nil] When an alert came in that this transaction will be disputed
           #
@@ -300,10 +319,16 @@ module WhopSDK
           #
           #   @param membership [WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment::Membership, nil] The membership attached to this payment.
           #
+          #   @param metadata [Hash{Symbol=>Object}, nil] The custom metadata stored on this payment. This will be copied over to the chec
+          #
           #   @param paid_at [Time, nil] The time at which this payment was successfully collected. Null if the payment h
           #
           #   @param payment_method_type [Symbol, WhopSDK::Models::PaymentMethodTypes, nil] The different types of payment methods that can be used.
           #
+          #   @param plan [WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment::Plan, nil] The plan attached to this payment.
+          #
+          #   @param product [WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment::Product, nil] The product this payment was made for
+          #
           #   @param subtotal [Float, nil] The subtotal to show to the creator (excluding buyer fees).
           #
           #   @param tax_amount [Float, nil] The calculated amount of the sales/VAT tax (if applicable).
@@ -362,6 +387,62 @@ module WhopSDK
             #   @param status [Symbol, WhopSDK::Models::MembershipStatus] The state of the membership.
           end
 
+          # @see WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment#plan
+          class Plan < WhopSDK::Internal::Type::BaseModel
+            # @!attribute id
+            #   The unique identifier for the plan.
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute metadata
+            #   Custom key-value pairs stored on the plan. Included in webhook payloads for
+            #   payment and membership events. Max 50 keys, 100 chars per key, 500 chars per
+            #   string value.
+            #
+            #   @return [Hash{Symbol=>Object}, nil]
+            required :metadata, WhopSDK::Internal::Type::HashOf[WhopSDK::Internal::Type::Unknown], nil?: true
+
+            # @!method initialize(id:, metadata:)
+            #   Some parameter documentations has been truncated, see
+            #   {WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment::Plan} for more
+            #   details.
+            #
+            #   The plan attached to this payment.
+            #
+            #   @param id [String] The unique identifier for the plan.
+            #
+            #   @param metadata [Hash{Symbol=>Object}, nil] Custom key-value pairs stored on the plan. Included in webhook payloads for paym
+          end
+
+          # @see WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment#product
+          class Product < WhopSDK::Internal::Type::BaseModel
+            # @!attribute id
+            #   The unique identifier for the product.
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute metadata
+            #   Custom key-value pairs stored on the product and included in payment and
+            #   membership webhook payloads. Max 50 keys, 100 characters per key, 500 characters
+            #   per string value.
+            #
+            #   @return [Hash{Symbol=>Object}, nil]
+            required :metadata, WhopSDK::Internal::Type::HashOf[WhopSDK::Internal::Type::Unknown], nil?: true
+
+            # @!method initialize(id:, metadata:)
+            #   Some parameter documentations has been truncated, see
+            #   {WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment::Product} for more
+            #   details.
+            #
+            #   The product this payment was made for
+            #
+            #   @param id [String] The unique identifier for the product.
+            #
+            #   @param metadata [Hash{Symbol=>Object}, nil] Custom key-value pairs stored on the product and included in payment and members
+          end
+
           # @see WhopSDK::Models::RefundUpdatedWebhookEvent::Data::Payment#user
           class User < WhopSDK::Internal::Type::BaseModel
             # @!attribute id

data/lib/whop_sdk/models/resolution_center_case_platform_response.rb

@@ -9,7 +9,6 @@ module WhopSDK
       REQUEST_BUYER_INFO = :request_buyer_info
       REQUEST_MERCHANT_INFO = :request_merchant_info
       MERCHANT_WINS = :merchant_wins
-      PLATFORM_REFUND = :platform_refund
       MERCHANT_REFUND = :merchant_refund
 
       # @!method self.values

data/lib/whop_sdk/models/result_label_keys.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    # Types of optimization results tracked from external ad platforms
+    module ResultLabelKeys
+      extend WhopSDK::Internal::Type::Enum
+
+      APP_INSTALLS = :app_installs
+      MESSAGING_CONVERSATIONS_STARTED = :messaging_conversations_started
+      POST_ENGAGEMENT = :post_engagement
+      EVENT_RESPONSES = :event_responses
+      IMPRESSIONS = :impressions
+      WEBSITE_PURCHASES = :website_purchases
+      LANDING_PAGE_VIEWS = :landing_page_views
+      LEADS = :leads
+      LINK_CLICKS = :link_clicks
+      QUALITY_CALLS = :quality_calls
+      APPOINTMENTS_BOOKED = :appointments_booked
+      MESSAGING_PURCHASES = :messaging_purchases
+      PAGE_LIKES = :page_likes
+      INSTAGRAM_PROFILE_VISITS = :instagram_profile_visits
+      REACH = :reach
+      REMINDERS_SET = :reminders_set
+      NEW_SUBSCRIBERS = :new_subscribers
+      VIDEO_VIEWS = :video_views
+      REGISTRATIONS = :registrations
+      CONTENT_VIEWS = :content_views
+      SEARCHES = :searches
+      ADDS_TO_CART = :adds_to_cart
+      ADDS_TO_WISHLIST = :adds_to_wishlist
+      ADDS_OF_PAYMENT_INFO = :adds_of_payment_info
+      CHECKOUTS_INITIATED = :checkouts_initiated
+      WEBSITE_SCHEDULES = :website_schedules
+      WEBSITE_SUBMIT_APPLICATIONS = :website_submit_applications
+      WEBSITE_TRIALS_STARTED = :website_trials_started
+      WEBSITE_SUBSCRIPTIONS = :website_subscriptions
+      WEBSITE_CONTACTS = :website_contacts
+      WEBSITE_DONATIONS = :website_donations
+      WEBSITE_FIND_LOCATIONS = :website_find_locations
+      WEBSITE_PRODUCT_CUSTOMIZATIONS = :website_product_customizations
+      CUSTOM = :custom
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/whop_sdk/models/review_list_response.rb

@@ -123,7 +123,7 @@ module WhopSDK
         required :id, String
 
         # @!attribute content_type
-        #   The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).
+        #   Uploaded file MIME type, such as image/jpeg, video/mp4, or audio/mpeg.
         #
         #   @return [String, nil]
         required :content_type, String, nil?: true
@@ -149,7 +149,7 @@ module WhopSDK
         #
         #   @param id [String] Represents a unique identifier that is Base64 obfuscated. It is often used to re
         #
-        #   @param content_type [String, nil] The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).
+        #   @param content_type [String, nil] Uploaded file MIME type, such as image/jpeg, video/mp4, or audio/mpeg.
         #
         #   @param filename [String, nil] The original filename of the uploaded attachment, including its file extension.
         #

data/lib/whop_sdk/models/review_retrieve_response.rb

@@ -139,7 +139,7 @@ module WhopSDK
         required :id, String
 
         # @!attribute content_type
-        #   The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).
+        #   Uploaded file MIME type, such as image/jpeg, video/mp4, or audio/mpeg.
         #
         #   @return [String, nil]
         required :content_type, String, nil?: true
@@ -165,7 +165,7 @@ module WhopSDK
         #
         #   @param id [String] Represents a unique identifier that is Base64 obfuscated. It is often used to re
         #
-        #   @param content_type [String, nil] The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).
+        #   @param content_type [String, nil] Uploaded file MIME type, such as image/jpeg, video/mp4, or audio/mpeg.
         #
         #   @param filename [String, nil] The original filename of the uploaded attachment, including its file extension.
         #
@@ -181,7 +181,7 @@ module WhopSDK
         required :id, String
 
         # @!attribute route
-        #   The URL slug for the company's store page (e.g., 'pickaxe' in whop.com/pickaxe).
+        #   URL slug for the account's store page, e.g. `pickaxe` in whop.com/pickaxe.
         #
         #   @return [String]
         required :route, String
@@ -193,14 +193,11 @@ module WhopSDK
         required :title, String
 
         # @!method initialize(id:, route:, title:)
-        #   Some parameter documentations has been truncated, see
-        #   {WhopSDK::Models::ReviewRetrieveResponse::Company} for more details.
-        #
         #   The company that this review was written for.
         #
         #   @param id [String] The unique identifier for the company.
         #
-        #   @param route [String] The URL slug for the company's store page (e.g., 'pickaxe' in whop.com/pickaxe).
+        #   @param route [String] URL slug for the account's store page, e.g. `pickaxe` in whop.com/pickaxe.
         #
         #   @param title [String] The display name of the company shown to customers.
       end

data/lib/whop_sdk/models/setup_intent.rb

@@ -64,7 +64,14 @@ module WhopSDK
       #   @return [Symbol, WhopSDK::Models::SetupIntentStatus]
       required :status, enum: -> { WhopSDK::SetupIntentStatus }
 
-      # @!method initialize(id:, checkout_configuration:, company:, created_at:, error_message:, member:, metadata:, payment_method:, status:)
+      # @!attribute three_ds_verified
+      #   Whether 3D Secure authentication was completed when this payment method was set
+      #   up.
+      #
+      #   @return [Boolean]
+      required :three_ds_verified, WhopSDK::Internal::Type::Boolean
+
+      # @!method initialize(id:, checkout_configuration:, company:, created_at:, error_message:, member:, metadata:, payment_method:, status:, three_ds_verified:)
       #   Some parameter documentations has been truncated, see
       #   {WhopSDK::Models::SetupIntent} for more details.
       #
@@ -88,6 +95,8 @@ module WhopSDK
       #   @param payment_method [WhopSDK::Models::SetupIntent::PaymentMethod, nil] The saved payment method created by this setup intent. Null if the setup has not
       #
       #   @param status [Symbol, WhopSDK::Models::SetupIntentStatus] The current status of the setup intent.
+      #
+      #   @param three_ds_verified [Boolean] Whether 3D Secure authentication was completed when this payment method was set
 
       # @see WhopSDK::Models::SetupIntent#checkout_configuration
       class CheckoutConfiguration < WhopSDK::Internal::Type::BaseModel

data/lib/whop_sdk/models/social_account.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    # @see WhopSDK::Resources::SocialAccounts#create
+    class SocialAccount < WhopSDK::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for the social account.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute external_id
+      #   The platform-specific ID for this social account.
+      #
+      #   @return [String, nil]
+      required :external_id, String, nil?: true
+
+      # @!attribute name
+      #   The display name of the social account on the platform.
+      #
+      #   @return [String, nil]
+      required :name, String, nil?: true
+
+      # @!attribute platform
+      #   The platform the social account exists on.
+      #
+      #   @return [Symbol, WhopSDK::Models::SocialAccount::Platform]
+      required :platform, enum: -> { WhopSDK::SocialAccount::Platform }
+
+      # @!attribute profile_picture_url
+      #   The URL where the profile picture of the social account can be accessed.
+      #
+      #   @return [String, nil]
+      required :profile_picture_url, String, nil?: true
+
+      # @!attribute scopes
+      #
+      #   @return [Array<String>]
+      required :scopes, WhopSDK::Internal::Type::ArrayOf[String]
+
+      # @!attribute url
+      #   The URL where the social account can be accessed on the platform. Null while a
+      #   Whop-owned page is still being provisioned.
+      #
+      #   @return [String, nil]
+      required :url, String, nil?: true
+
+      # @!attribute username
+      #   The username of the social account on the platform. Null while a Whop-owned page
+      #   is still being provisioned.
+      #
+      #   @return [String, nil]
+      required :username, String, nil?: true
+
+      # @!attribute verified
+      #   Whether the social account is verified on the platform.
+      #
+      #   @return [Boolean]
+      required :verified, WhopSDK::Internal::Type::Boolean
+
+      # @!method initialize(id:, external_id:, name:, platform:, profile_picture_url:, scopes:, url:, username:, verified:)
+      #   Some parameter documentations has been truncated, see
+      #   {WhopSDK::Models::SocialAccount} for more details.
+      #
+      #   @param id [String] Unique identifier for the social account.
+      #
+      #   @param external_id [String, nil] The platform-specific ID for this social account.
+      #
+      #   @param name [String, nil] The display name of the social account on the platform.
+      #
+      #   @param platform [Symbol, WhopSDK::Models::SocialAccount::Platform] The platform the social account exists on.
+      #
+      #   @param profile_picture_url [String, nil] The URL where the profile picture of the social account can be accessed.
+      #
+      #   @param scopes [Array<String>]
+      #
+      #   @param url [String, nil] The URL where the social account can be accessed on the platform. Null while a W
+      #
+      #   @param username [String, nil] The username of the social account on the platform. Null while a Whop-owned page
+      #
+      #   @param verified [Boolean] Whether the social account is verified on the platform.
+
+      # The platform the social account exists on.
+      #
+      # @see WhopSDK::Models::SocialAccount#platform
+      module Platform
+        extend WhopSDK::Internal::Type::Enum
+
+        X = :x
+        INSTAGRAM = :instagram
+        YOUTUBE = :youtube
+        TIKTOK = :tiktok
+        FACEBOOK = :facebook
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/whop_sdk/models/social_account_connect_params.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    # @see WhopSDK::Resources::SocialAccounts#connect
+    class SocialAccountConnectParams < WhopSDK::Internal::Type::BaseModel
+      extend WhopSDK::Internal::Type::RequestParameters::Converter
+      include WhopSDK::Internal::Type::RequestParameters
+
+      # @!attribute platform
+      #   The platform to connect the social account on. Today, the supported option is
+      #   `meta_business`.
+      #
+      #   @return [Symbol, WhopSDK::Models::SocialAccountConnectParams::Platform]
+      required :platform, enum: -> { WhopSDK::SocialAccountConnectParams::Platform }
+
+      # @!attribute account_id
+      #   The Account (biz\_ identifier) to connect the social account for. An
+      #   account-scoped API key may omit this to default to its own account.
+      #
+      #   @return [String, nil]
+      optional :account_id, String
+
+      # @!attribute redirect_url
+      #   The Whop URL to redirect the user to after they finish connecting.
+      #
+      #   @return [String, nil]
+      optional :redirect_url, String
+
+      # @!attribute scopes
+      #   Capabilities to grant for the connected social account. Use `advertise` when
+      #   connecting a Meta Business account for ads.
+      #
+      #   @return [Array<Symbol, WhopSDK::Models::SocialAccountConnectParams::Scope>, nil]
+      optional :scopes,
+               -> { WhopSDK::Internal::Type::ArrayOf[enum: WhopSDK::SocialAccountConnectParams::Scope] }
+
+      # @!method initialize(platform:, account_id: nil, redirect_url: nil, scopes: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {WhopSDK::Models::SocialAccountConnectParams} for more details.
+      #
+      #   @param platform [Symbol, WhopSDK::Models::SocialAccountConnectParams::Platform] The platform to connect the social account on. Today, the supported option is `m
+      #
+      #   @param account_id [String] The Account (biz\_ identifier) to connect the social account for. An
+      #   account-scop
+      #
+      #   @param redirect_url [String] The Whop URL to redirect the user to after they finish connecting.
+      #
+      #   @param scopes [Array<Symbol, WhopSDK::Models::SocialAccountConnectParams::Scope>] Capabilities to grant for the connected social account. Use `advertise` when con
+      #
+      #   @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}]
+
+      # The platform to connect the social account on. Today, the supported option is
+      # `meta_business`.
+      module Platform
+        extend WhopSDK::Internal::Type::Enum
+
+        META_BUSINESS = :meta_business
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      module Scope
+        extend WhopSDK::Internal::Type::Enum
+
+        ADVERTISE = :advertise
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/whop_sdk/models/social_account_connect_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    # @see WhopSDK::Resources::SocialAccounts#connect
+    class SocialAccountConnectResponse < WhopSDK::Internal::Type::BaseModel
+      # @!attribute authorize_url
+      #   The OAuth authorization URL to redirect the user to.
+      #
+      #   @return [String]
+      required :authorize_url, String
+
+      # @!method initialize(authorize_url:)
+      #   @param authorize_url [String] The OAuth authorization URL to redirect the user to.
+    end
+  end
+end

data/lib/whop_sdk/models/social_account_create_params.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    # @see WhopSDK::Resources::SocialAccounts#create
+    class SocialAccountCreateParams < WhopSDK::Internal::Type::BaseModel
+      extend WhopSDK::Internal::Type::RequestParameters::Converter
+      include WhopSDK::Internal::Type::RequestParameters
+
+      # @!attribute platform
+      #   The platform to create the social account on.
+      #
+      #   @return [Symbol, WhopSDK::Models::SocialAccountCreateParams::Platform]
+      required :platform, enum: -> { WhopSDK::SocialAccountCreateParams::Platform }
+
+      # @!attribute account_id
+      #   The Account (biz\_ identifier) to create the social account for. An
+      #   account-scoped API key may omit this to default to its own account.
+      #
+      #   @return [String, nil]
+      optional :account_id, String
+
+      # @!method initialize(platform:, account_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {WhopSDK::Models::SocialAccountCreateParams} for more details.
+      #
+      #   @param platform [Symbol, WhopSDK::Models::SocialAccountCreateParams::Platform] The platform to create the social account on.
+      #
+      #   @param account_id [String] The Account (biz\_ identifier) to create the social account for. An
+      #   account-scope
+      #
+      #   @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}]
+
+      # The platform to create the social account on.
+      module Platform
+        extend WhopSDK::Internal::Type::Enum
+
+        FACEBOOK = :facebook
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end