surge_api 0.14.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ab96cd22457002ccedc81712121dba63dbae5e4cf07727d9b993b92fd0969b0
-  data.tar.gz: 1eb78284fdc3b52214c58857cd45cc36133b344e95a10066dbd4b2b89636354d
+  metadata.gz: 614370dfa43aa94b2c07f29576b6e5859d11010ede1baa50269ff5d2d1ceccc9
+  data.tar.gz: a1717cedfe90b25cb8ad1c6fc529bd89ed6bead53039a37c0c1d99883fae1b42
 SHA512:
-  metadata.gz: 66e8cbb2c329875bd0eada2097083f37de865d9909c421cd8a40b05b003f6c79f2ed4bb0137ac2f77d8159077499f12371c0a59dd4a47316fc02fb4d3eb37f4d
-  data.tar.gz: 51690c17e967f65a50ecde699f3ebd40b88dbc67bf53add883b147698c4fcb8e2477a12f346d4beb93d7d9ceda221b57c3e9a9604a0e3903eea2c954bc5b2fd1
+  metadata.gz: 139587949698301477b68cb7a99f4b3367bc9575369ba153bb318f94dc488120348fb19a0ec2d566fd0407ddada88cddbfbf8ad1ac26640685e052408e29b6c4
+  data.tar.gz: 53b59055a002e7720fe165241c3ef0df906657d900dcb729da9be4a06e93a947a407eb7d73816a4aa76dac178e885f321f9528169e39f9ec719e4ab60fa27da1

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.15.0 (2026-04-06)
+
+Full Changelog: [v0.14.0...v0.15.0](https://github.com/surgeapi/ruby-sdk/compare/v0.14.0...v0.15.0)
+
+### Features
+
+* **api:** create an audience ([817fd30](https://github.com/surgeapi/ruby-sdk/commit/817fd3063e6346d452062fb720b42495f030d1e9))
+* **api:** require terms_and_conditions_url for campaigns ([859ee36](https://github.com/surgeapi/ruby-sdk/commit/859ee3658653d0c0dfee2b7d6118e4adf7cb9c46))
+* **api:** update a campaign ([b22a5e4](https://github.com/surgeapi/ruby-sdk/commit/b22a5e438e80654d4ea05572d4e54c32594eba22))
+
 ## 0.14.0 (2026-04-01)
 
 Full Changelog: [v0.13.0...v0.14.0](https://github.com/surgeapi/ruby-sdk/compare/v0.13.0...v0.14.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "surge_api", "~> 0.14.0"
+gem "surge_api", "~> 0.15.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/surge_api/models/audience_create_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Audiences#create
+    class AudienceCreateParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      # @!attribute name
+      #   The audience name.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!method initialize(name:, request_options: {})
+      #   @param name [String] The audience name.
+      #
+      #   @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/surge_api/models/audience_create_response.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Audiences#create
+    class AudienceCreateResponse < SurgeAPI::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for the object.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute name
+      #   A name to identify this Audience. This name will only be visible within Surge.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!method initialize(id:, name:)
+      #   A group of contacts used for targeting messages.
+      #
+      #   @param id [String] Unique identifier for the object.
+      #
+      #   @param name [String] A name to identify this Audience. This name will only be visible within Surge.
+    end
+  end
+end

data/lib/surge_api/models/campaign_params.rb

@@ -50,6 +50,15 @@ module SurgeAPI
         #   @return [String]
         required :privacy_policy_url, String
 
+        # @!attribute terms_and_conditions_url
+        #   The URL of the terms and conditions presented to end users when they opt in to
+        #   messaging. These terms and conditions may be shared among all of a platform's
+        #   customers if they're the terms that are presented to end users when they opt in
+        #   to messaging.
+        #
+        #   @return [String]
+        required :terms_and_conditions_url, String
+
         # @!attribute use_cases
         #   A list containing 1-5 types of messages that will be sent with this campaign.
         #
@@ -122,16 +131,7 @@ module SurgeAPI
         #   @return [String, nil]
         optional :link_sample, String
 
-        # @!attribute terms_and_conditions_url
-        #   The URL of the terms and conditions presented to end users when they opt in to
-        #   messaging. These terms and conditions may be shared among all of a platform's
-        #   customers if they're the terms that are presented to end users when they opt in
-        #   to messaging.
-        #
-        #   @return [String, nil]
-        optional :terms_and_conditions_url, String
-
-        # @!method initialize(consent_flow:, description:, message_samples:, privacy_policy_url:, use_cases:, volume:, includes: nil, link_sample: nil, terms_and_conditions_url: nil)
+        # @!method initialize(consent_flow:, description:, message_samples:, privacy_policy_url:, terms_and_conditions_url:, use_cases:, volume:, includes: nil, link_sample: nil)
         #   Some parameter documentations has been truncated, see
         #   {SurgeAPI::Models::CampaignParams::StandardCampaignParams} for more details.
         #
@@ -145,6 +145,8 @@ module SurgeAPI
         #
         #   @param privacy_policy_url [String] The URL of the privacy policy for the brand in question. This may be a shared pr
         #
+        #   @param terms_and_conditions_url [String] The URL of the terms and conditions presented to end users when they opt in to m
+        #
         #   @param use_cases [Array<Symbol, SurgeAPI::Models::CampaignParams::StandardCampaignParams::UseCase>] A list containing 1-5 types of messages that will be sent with this campaign.
         #
         #   @param volume [Symbol, SurgeAPI::Models::CampaignParams::StandardCampaignParams::Volume] This will be one of the following:
@@ -152,8 +154,6 @@ module SurgeAPI
         #   @param includes [Array<Symbol, SurgeAPI::Models::CampaignParams::StandardCampaignParams::Include>] A list of properties that this campaign should include. These properties can be
         #
         #   @param link_sample [String] A sample link that might be sent by this campaign. If links from other domains a
-        #
-        #   @param terms_and_conditions_url [String] The URL of the terms and conditions presented to end users when they opt in to m
 
         module UseCase
           extend SurgeAPI::Internal::Type::Enum

data/lib/surge_api/models/campaign_update_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Campaigns#update
+    class CampaignUpdateParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      # @!attribute campaign_params
+      #   Parameters for creating a new campaign. Either provide full campaign details or
+      #   import using a TCR ID.
+      #
+      #   @return [SurgeAPI::Models::CampaignParams::StandardCampaignParams, SurgeAPI::Models::CampaignParams::ExternalCampaignParams]
+      required :campaign_params, union: -> { SurgeAPI::CampaignParams }
+
+      # @!method initialize(campaign_params:, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {SurgeAPI::Models::CampaignUpdateParams} for more details.
+      #
+      #   @param campaign_params [SurgeAPI::Models::CampaignParams::StandardCampaignParams, SurgeAPI::Models::CampaignParams::ExternalCampaignParams] Parameters for creating a new campaign. Either provide full campaign details or
+      #
+      #   @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/surge_api/models.rb

@@ -53,6 +53,8 @@ module SurgeAPI
 
   AudienceAddContactParams = SurgeAPI::Models::AudienceAddContactParams
 
+  AudienceCreateParams = SurgeAPI::Models::AudienceCreateParams
+
   AudienceListContactsParams = SurgeAPI::Models::AudienceListContactsParams
 
   Blast = SurgeAPI::Models::Blast
@@ -73,6 +75,8 @@ module SurgeAPI
 
   CampaignRetrieveParams = SurgeAPI::Models::CampaignRetrieveParams
 
+  CampaignUpdateParams = SurgeAPI::Models::CampaignUpdateParams
+
   Contact = SurgeAPI::Models::Contact
 
   ContactCreateParams = SurgeAPI::Models::ContactCreateParams

data/lib/surge_api/resources/audiences.rb

@@ -3,6 +3,30 @@
 module SurgeAPI
   module Resources
     class Audiences
+      # Creates a new audience.
+      #
+      # @overload create(account_id, name:, request_options: {})
+      #
+      # @param account_id [String] The account for which the audience should be created.
+      #
+      # @param name [String] The audience name.
+      #
+      # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SurgeAPI::Models::AudienceCreateResponse]
+      #
+      # @see SurgeAPI::Models::AudienceCreateParams
+      def create(account_id, params)
+        parsed, options = SurgeAPI::AudienceCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["accounts/%1$s/audiences", account_id],
+          body: parsed,
+          model: SurgeAPI::Models::AudienceCreateResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {SurgeAPI::Models::AudienceAddContactParams} for more details.
       #

data/lib/surge_api/resources/campaigns.rb

@@ -55,6 +55,41 @@ module SurgeAPI
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {SurgeAPI::Models::CampaignUpdateParams} for more details.
+      #
+      # Updates a campaign that has not yet been approved. This can be used to fix
+      # issues flagged during review and resubmit the campaign. Returns an error if the
+      # campaign is currently in review, has already been approved, or has been
+      # deactivated.
+      #
+      # @overload update(id, campaign_params:, request_options: {})
+      #
+      # @param id [String] The ID of the campaign to update.
+      #
+      # @param campaign_params [SurgeAPI::CampaignParams] Parameters for creating a new campaign. Either provide full campaign details or
+      #
+      # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SurgeAPI::Models::Campaign]
+      #
+      # @see SurgeAPI::Models::CampaignUpdateParams
+      def update(id, params)
+        parsed, options = SurgeAPI::CampaignUpdateParams.dump_request(params)
+        case parsed
+        in {campaign_params: Hash => union, **rest}
+          parsed = {**rest, **union}
+        else
+        end
+        @client.request(
+          method: :patch,
+          path: ["campaigns/%1$s", id],
+          body: parsed,
+          model: SurgeAPI::Campaign,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {SurgeAPI::Models::CampaignListParams} for more details.
       #

data/lib/surge_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SurgeAPI
-  VERSION = "0.14.0"
+  VERSION = "0.15.0"
 end

data/lib/surge_api.rb

@@ -62,6 +62,8 @@ require_relative "surge_api/models/account_retrieve_status_params"
 require_relative "surge_api/models/account_status"
 require_relative "surge_api/models/account_update_params"
 require_relative "surge_api/models/audience_add_contact_params"
+require_relative "surge_api/models/audience_create_params"
+require_relative "surge_api/models/audience_create_response"
 require_relative "surge_api/models/audience_list_contacts_params"
 require_relative "surge_api/models/blast"
 require_relative "surge_api/models/blast_create_params"
@@ -71,6 +73,7 @@ require_relative "surge_api/models/campaign_approved_webhook_event"
 require_relative "surge_api/models/campaign_create_params"
 require_relative "surge_api/models/campaign_list_params"
 require_relative "surge_api/models/campaign_retrieve_params"
+require_relative "surge_api/models/campaign_update_params"
 require_relative "surge_api/models/contact"
 require_relative "surge_api/models/contact_create_params"
 require_relative "surge_api/models/contact_list_params"

data/rbi/surge_api/models/audience_create_params.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class AudienceCreateParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(SurgeAPI::AudienceCreateParams, SurgeAPI::Internal::AnyHash)
+        end
+
+      # The audience name.
+      sig { returns(String) }
+      attr_accessor :name
+
+      sig do
+        params(
+          name: String,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The audience name.
+        name:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          { name: String, request_options: SurgeAPI::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/surge_api/models/audience_create_response.rbi

@@ -0,0 +1,37 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class AudienceCreateResponse < SurgeAPI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SurgeAPI::Models::AudienceCreateResponse,
+            SurgeAPI::Internal::AnyHash
+          )
+        end
+
+      # Unique identifier for the object.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # A name to identify this Audience. This name will only be visible within Surge.
+      sig { returns(String) }
+      attr_accessor :name
+
+      # A group of contacts used for targeting messages.
+      sig { params(id: String, name: String).returns(T.attached_class) }
+      def self.new(
+        # Unique identifier for the object.
+        id:,
+        # A name to identify this Audience. This name will only be visible within Surge.
+        name:
+      )
+      end
+
+      sig { override.returns({ id: String, name: String }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/surge_api/models/campaign_params.rbi

@@ -52,6 +52,13 @@ module SurgeAPI
         sig { returns(String) }
         attr_accessor :privacy_policy_url
 
+        # The URL of the terms and conditions presented to end users when they opt in to
+        # messaging. These terms and conditions may be shared among all of a platform's
+        # customers if they're the terms that are presented to end users when they opt in
+        # to messaging.
+        sig { returns(String) }
+        attr_accessor :terms_and_conditions_url
+
         # A list containing 1-5 types of messages that will be sent with this campaign.
         #
         # The following use cases are typically available to all brands:
@@ -145,16 +152,6 @@ module SurgeAPI
         sig { params(link_sample: String).void }
         attr_writer :link_sample
 
-        # The URL of the terms and conditions presented to end users when they opt in to
-        # messaging. These terms and conditions may be shared among all of a platform's
-        # customers if they're the terms that are presented to end users when they opt in
-        # to messaging.
-        sig { returns(T.nilable(String)) }
-        attr_reader :terms_and_conditions_url
-
-        sig { params(terms_and_conditions_url: String).void }
-        attr_writer :terms_and_conditions_url
-
         # Full campaign details for standard registration through Surge
         sig do
           params(
@@ -162,6 +159,7 @@ module SurgeAPI
             description: String,
             message_samples: T::Array[String],
             privacy_policy_url: String,
+            terms_and_conditions_url: String,
             use_cases:
               T::Array[
                 SurgeAPI::CampaignParams::StandardCampaignParams::UseCase::OrSymbol
@@ -172,8 +170,7 @@ module SurgeAPI
               T::Array[
                 SurgeAPI::CampaignParams::StandardCampaignParams::Include::OrSymbol
               ],
-            link_sample: String,
-            terms_and_conditions_url: String
+            link_sample: String
           ).returns(T.attached_class)
         end
         def self.new(
@@ -197,6 +194,11 @@ module SurgeAPI
           # privacy policy if it's the policy that is displayed to end users when they opt
           # in to messaging.
           privacy_policy_url:,
+          # The URL of the terms and conditions presented to end users when they opt in to
+          # messaging. These terms and conditions may be shared among all of a platform's
+          # customers if they're the terms that are presented to end users when they opt in
+          # to messaging.
+          terms_and_conditions_url:,
           # A list containing 1-5 types of messages that will be sent with this campaign.
           #
           # The following use cases are typically available to all brands:
@@ -250,12 +252,7 @@ module SurgeAPI
           # carriers. If link shortening is enabled for the account, the link shortener URL
           # will be used instead of what is provided. Reach out to support if you would like
           # to disable automatic link shortening.
-          link_sample: nil,
-          # The URL of the terms and conditions presented to end users when they opt in to
-          # messaging. These terms and conditions may be shared among all of a platform's
-          # customers if they're the terms that are presented to end users when they opt in
-          # to messaging.
-          terms_and_conditions_url: nil
+          link_sample: nil
         )
         end
 
@@ -266,6 +263,7 @@ module SurgeAPI
               description: String,
               message_samples: T::Array[String],
               privacy_policy_url: String,
+              terms_and_conditions_url: String,
               use_cases:
                 T::Array[
                   SurgeAPI::CampaignParams::StandardCampaignParams::UseCase::OrSymbol
@@ -276,8 +274,7 @@ module SurgeAPI
                 T::Array[
                   SurgeAPI::CampaignParams::StandardCampaignParams::Include::OrSymbol
                 ],
-              link_sample: String,
-              terms_and_conditions_url: String
+              link_sample: String
             }
           )
         end

data/rbi/surge_api/models/campaign_update_params.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class CampaignUpdateParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(SurgeAPI::CampaignUpdateParams, SurgeAPI::Internal::AnyHash)
+        end
+
+      # Parameters for creating a new campaign. Either provide full campaign details or
+      # import using a TCR ID.
+      sig do
+        returns(
+          T.any(
+            SurgeAPI::CampaignParams::StandardCampaignParams,
+            SurgeAPI::CampaignParams::ExternalCampaignParams
+          )
+        )
+      end
+      attr_accessor :campaign_params
+
+      sig do
+        params(
+          campaign_params:
+            T.any(
+              SurgeAPI::CampaignParams::StandardCampaignParams::OrHash,
+              SurgeAPI::CampaignParams::ExternalCampaignParams::OrHash
+            ),
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Parameters for creating a new campaign. Either provide full campaign details or
+        # import using a TCR ID.
+        campaign_params:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            campaign_params:
+              T.any(
+                SurgeAPI::CampaignParams::StandardCampaignParams,
+                SurgeAPI::CampaignParams::ExternalCampaignParams
+              ),
+            request_options: SurgeAPI::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/surge_api/models.rbi

@@ -15,6 +15,8 @@ module SurgeAPI
 
   AudienceAddContactParams = SurgeAPI::Models::AudienceAddContactParams
 
+  AudienceCreateParams = SurgeAPI::Models::AudienceCreateParams
+
   AudienceListContactsParams = SurgeAPI::Models::AudienceListContactsParams
 
   Blast = SurgeAPI::Models::Blast
@@ -35,6 +37,8 @@ module SurgeAPI
 
   CampaignRetrieveParams = SurgeAPI::Models::CampaignRetrieveParams
 
+  CampaignUpdateParams = SurgeAPI::Models::CampaignUpdateParams
+
   Contact = SurgeAPI::Models::Contact
 
   ContactCreateParams = SurgeAPI::Models::ContactCreateParams

data/rbi/surge_api/resources/audiences.rbi

@@ -3,6 +3,23 @@
 module SurgeAPI
   module Resources
     class Audiences
+      # Creates a new audience.
+      sig do
+        params(
+          account_id: String,
+          name: String,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(SurgeAPI::Models::AudienceCreateResponse)
+      end
+      def create(
+        # The account for which the audience should be created.
+        account_id,
+        # The audience name.
+        name:,
+        request_options: {}
+      )
+      end
+
       # Adds an existing contact to a manual audience.
       sig do
         params(

data/rbi/surge_api/resources/campaigns.rbi

@@ -35,6 +35,27 @@ module SurgeAPI
       )
       end
 
+      # Updates a campaign that has not yet been approved. This can be used to fix
+      # issues flagged during review and resubmit the campaign. Returns an error if the
+      # campaign is currently in review, has already been approved, or has been
+      # deactivated.
+      sig do
+        params(
+          id: String,
+          campaign_params: SurgeAPI::CampaignParams,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(SurgeAPI::Campaign)
+      end
+      def update(
+        # The ID of the campaign to update.
+        id,
+        # Parameters for creating a new campaign. Either provide full campaign details or
+        # import using a TCR ID.
+        campaign_params:,
+        request_options: {}
+      )
+      end
+
       # List all campaigns for an account with cursor-based pagination.
       sig do
         params(

data/sig/surge_api/models/audience_create_params.rbs

@@ -0,0 +1,23 @@
+module SurgeAPI
+  module Models
+    type audience_create_params =
+      { name: String } & SurgeAPI::Internal::Type::request_parameters
+
+    class AudienceCreateParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      attr_accessor name: String
+
+      def initialize: (
+        name: String,
+        ?request_options: SurgeAPI::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        name: String,
+        request_options: SurgeAPI::RequestOptions
+      }
+    end
+  end
+end

data/sig/surge_api/models/audience_create_response.rbs

@@ -0,0 +1,15 @@
+module SurgeAPI
+  module Models
+    type audience_create_response = { id: String, name: String }
+
+    class AudienceCreateResponse < SurgeAPI::Internal::Type::BaseModel
+      attr_accessor id: String
+
+      attr_accessor name: String
+
+      def initialize: (id: String, name: String) -> void
+
+      def to_hash: -> { id: String, name: String }
+    end
+  end
+end

data/sig/surge_api/models/campaign_params.rbs

@@ -13,11 +13,11 @@ module SurgeAPI
           description: String,
           message_samples: ::Array[String],
           privacy_policy_url: String,
+          terms_and_conditions_url: String,
           use_cases: ::Array[SurgeAPI::Models::CampaignParams::StandardCampaignParams::use_case],
           volume: SurgeAPI::Models::CampaignParams::StandardCampaignParams::volume,
           includes: ::Array[SurgeAPI::Models::CampaignParams::StandardCampaignParams::include_],
-          link_sample: String,
-          terms_and_conditions_url: String
+          link_sample: String
         }
 
       class StandardCampaignParams < SurgeAPI::Internal::Type::BaseModel
@@ -29,6 +29,8 @@ module SurgeAPI
 
         attr_accessor privacy_policy_url: String
 
+        attr_accessor terms_and_conditions_url: String
+
         attr_accessor use_cases: ::Array[SurgeAPI::Models::CampaignParams::StandardCampaignParams::use_case]
 
         attr_accessor volume: SurgeAPI::Models::CampaignParams::StandardCampaignParams::volume
@@ -43,20 +45,16 @@ module SurgeAPI
 
         def link_sample=: (String) -> String
 
-        attr_reader terms_and_conditions_url: String?
-
-        def terms_and_conditions_url=: (String) -> String
-
         def initialize: (
           consent_flow: String,
           description: String,
           message_samples: ::Array[String],
           privacy_policy_url: String,
+          terms_and_conditions_url: String,
           use_cases: ::Array[SurgeAPI::Models::CampaignParams::StandardCampaignParams::use_case],
           volume: SurgeAPI::Models::CampaignParams::StandardCampaignParams::volume,
           ?includes: ::Array[SurgeAPI::Models::CampaignParams::StandardCampaignParams::include_],
-          ?link_sample: String,
-          ?terms_and_conditions_url: String
+          ?link_sample: String
         ) -> void
 
         def to_hash: -> {
@@ -64,11 +62,11 @@ module SurgeAPI
           description: String,
           message_samples: ::Array[String],
           privacy_policy_url: String,
+          terms_and_conditions_url: String,
           use_cases: ::Array[SurgeAPI::Models::CampaignParams::StandardCampaignParams::use_case],
           volume: SurgeAPI::Models::CampaignParams::StandardCampaignParams::volume,
           includes: ::Array[SurgeAPI::Models::CampaignParams::StandardCampaignParams::include_],
-          link_sample: String,
-          terms_and_conditions_url: String
+          link_sample: String
         }
 
         type use_case =

data/sig/surge_api/models/campaign_update_params.rbs

@@ -0,0 +1,28 @@
+module SurgeAPI
+  module Models
+    type campaign_update_params =
+      { campaign_params: SurgeAPI::Models::campaign_params }
+      & SurgeAPI::Internal::Type::request_parameters
+
+    class CampaignUpdateParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      def campaign_params: -> SurgeAPI::Models::campaign_params
+
+      def campaign_params=: (
+        SurgeAPI::Models::campaign_params _
+      ) -> SurgeAPI::Models::campaign_params
+
+      def initialize: (
+        campaign_params: SurgeAPI::Models::campaign_params,
+        ?request_options: SurgeAPI::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        campaign_params: SurgeAPI::Models::campaign_params,
+        request_options: SurgeAPI::RequestOptions
+      }
+    end
+  end
+end

data/sig/surge_api/models.rbs

@@ -13,6 +13,8 @@ module SurgeAPI
 
   class AudienceAddContactParams = SurgeAPI::Models::AudienceAddContactParams
 
+  class AudienceCreateParams = SurgeAPI::Models::AudienceCreateParams
+
   class AudienceListContactsParams = SurgeAPI::Models::AudienceListContactsParams
 
   class Blast = SurgeAPI::Models::Blast
@@ -33,6 +35,8 @@ module SurgeAPI
 
   class CampaignRetrieveParams = SurgeAPI::Models::CampaignRetrieveParams
 
+  class CampaignUpdateParams = SurgeAPI::Models::CampaignUpdateParams
+
   class Contact = SurgeAPI::Models::Contact
 
   class ContactCreateParams = SurgeAPI::Models::ContactCreateParams

data/sig/surge_api/resources/audiences.rbs

@@ -1,6 +1,12 @@
 module SurgeAPI
   module Resources
     class Audiences
+      def create: (
+        String account_id,
+        name: String,
+        ?request_options: SurgeAPI::request_opts
+      ) -> SurgeAPI::Models::AudienceCreateResponse
+
       def add_contact: (
         String audience_id,
         id: String,

data/sig/surge_api/resources/campaigns.rbs

@@ -12,6 +12,12 @@ module SurgeAPI
         ?request_options: SurgeAPI::request_opts
       ) -> SurgeAPI::Campaign
 
+      def update: (
+        String id,
+        campaign_params: SurgeAPI::Models::CampaignParams,
+        ?request_options: SurgeAPI::request_opts
+      ) -> SurgeAPI::Campaign
+
       def list: (
         String account_id,
         ?after: String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: surge_api
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.15.0
 platform: ruby
 authors:
 - Surge
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-01 00:00:00.000000000 Z
+date: 2026-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -77,6 +77,8 @@ files:
 - lib/surge_api/models/account_status.rb
 - lib/surge_api/models/account_update_params.rb
 - lib/surge_api/models/audience_add_contact_params.rb
+- lib/surge_api/models/audience_create_params.rb
+- lib/surge_api/models/audience_create_response.rb
 - lib/surge_api/models/audience_list_contacts_params.rb
 - lib/surge_api/models/blast.rb
 - lib/surge_api/models/blast_create_params.rb
@@ -87,6 +89,7 @@ files:
 - lib/surge_api/models/campaign_list_params.rb
 - lib/surge_api/models/campaign_params.rb
 - lib/surge_api/models/campaign_retrieve_params.rb
+- lib/surge_api/models/campaign_update_params.rb
 - lib/surge_api/models/contact.rb
 - lib/surge_api/models/contact_create_params.rb
 - lib/surge_api/models/contact_list_params.rb
@@ -176,6 +179,8 @@ files:
 - rbi/surge_api/models/account_status.rbi
 - rbi/surge_api/models/account_update_params.rbi
 - rbi/surge_api/models/audience_add_contact_params.rbi
+- rbi/surge_api/models/audience_create_params.rbi
+- rbi/surge_api/models/audience_create_response.rbi
 - rbi/surge_api/models/audience_list_contacts_params.rbi
 - rbi/surge_api/models/blast.rbi
 - rbi/surge_api/models/blast_create_params.rbi
@@ -186,6 +191,7 @@ files:
 - rbi/surge_api/models/campaign_list_params.rbi
 - rbi/surge_api/models/campaign_params.rbi
 - rbi/surge_api/models/campaign_retrieve_params.rbi
+- rbi/surge_api/models/campaign_update_params.rbi
 - rbi/surge_api/models/contact.rbi
 - rbi/surge_api/models/contact_create_params.rbi
 - rbi/surge_api/models/contact_list_params.rbi
@@ -274,6 +280,8 @@ files:
 - sig/surge_api/models/account_status.rbs
 - sig/surge_api/models/account_update_params.rbs
 - sig/surge_api/models/audience_add_contact_params.rbs
+- sig/surge_api/models/audience_create_params.rbs
+- sig/surge_api/models/audience_create_response.rbs
 - sig/surge_api/models/audience_list_contacts_params.rbs
 - sig/surge_api/models/blast.rbs
 - sig/surge_api/models/blast_create_params.rbs
@@ -284,6 +292,7 @@ files:
 - sig/surge_api/models/campaign_list_params.rbs
 - sig/surge_api/models/campaign_params.rbs
 - sig/surge_api/models/campaign_retrieve_params.rbs
+- sig/surge_api/models/campaign_update_params.rbs
 - sig/surge_api/models/contact.rbs
 - sig/surge_api/models/contact_create_params.rbs
 - sig/surge_api/models/contact_list_params.rbs