surge_api 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c36ef735ac45405fb4d5f91cfdd8c6993370f5e130a02aecf8421e4e1158c1e9
-  data.tar.gz: 3af2cc39257fa57acb0a2b42ae74ad17f1159b5e07c73478b98a759e4a02c070
+  metadata.gz: 4ab96cd22457002ccedc81712121dba63dbae5e4cf07727d9b993b92fd0969b0
+  data.tar.gz: 1eb78284fdc3b52214c58857cd45cc36133b344e95a10066dbd4b2b89636354d
 SHA512:
-  metadata.gz: e87b415e0cdb6e142d8e5f438767c715f0ff455a94ca80e6eaf88631f0aefbd91c60eb87e56c18758d6b0bcdd07170d46bae507eb8d4fb71c6118a7f84677973
-  data.tar.gz: 46a8c93de7a473bd99a31ad51cd736312afafdb1a28c2319bdab231c2a96bcd17a748eb484a347d51249ad6f938aaf080720c37ca2fef7af755dc5ecece64ead
+  metadata.gz: 66e8cbb2c329875bd0eada2097083f37de865d9909c421cd8a40b05b003f6c79f2ed4bb0137ac2f77d8159077499f12371c0a59dd4a47316fc02fb4d3eb37f4d
+  data.tar.gz: 51690c17e967f65a50ecde699f3ebd40b88dbc67bf53add883b147698c4fcb8e2477a12f346d4beb93d7d9ceda221b57c3e9a9604a0e3903eea2c954bc5b2fd1

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* **api:** add a contact to an audience ([e018d30](https://github.com/surgeapi/ruby-sdk/commit/e018d30efea8ab2796e5c8ba74e1bef5e582abe0))
+* **api:** allow canadian organizations ([0291b0c](https://github.com/surgeapi/ruby-sdk/commit/0291b0c4d0209f6b7f47a755501f2c863e798f67))
+* **api:** list contacts in audiences ([75df97d](https://github.com/surgeapi/ruby-sdk/commit/75df97dace94cbdb661a82ee360a89f270216c84))
+
+
+### Documentation
+
+* **api:** allow Canadian mobile number ([b5c8e47](https://github.com/surgeapi/ruby-sdk/commit/b5c8e477b89659b6a0554ffcada847e481138311))
+
 ## 0.13.0 (2026-03-24)
 
 Full Changelog: [v0.12.0...v0.13.0](https://github.com/surgeapi/ruby-sdk/compare/v0.12.0...v0.13.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.13.0"
+gem "surge_api", "~> 0.14.0"
 ```
 
 <!-- x-release-please-end -->
@@ -44,15 +44,15 @@ List methods in the Surge API are paginated.
 This library provides auto-paginating iterators with each list response, so you do not have to request successive pages manually:
 
 ```ruby
-page = surge.campaigns.list
+page = surge.audiences.list_contacts
 
 # Fetch single item from page.
-campaign = page.data[0]
-puts(campaign.id)
+audience = page.data[0]
+puts(audience.id)
 
 # Automatically fetches more pages as needed.
-page.auto_paging_each do |campaign|
-  puts(campaign.id)
+page.auto_paging_each do |audience|
+  puts(audience.id)
 end
 ```
 

data/lib/surge_api/client.rb

@@ -21,6 +21,9 @@ module SurgeAPI
     # @return [SurgeAPI::Resources::Accounts]
     attr_reader :accounts
 
+    # @return [SurgeAPI::Resources::Audiences]
+    attr_reader :audiences
+
     # @return [SurgeAPI::Resources::Blasts]
     attr_reader :blasts
 
@@ -96,6 +99,7 @@ module SurgeAPI
       )
 
       @accounts = SurgeAPI::Resources::Accounts.new(client: self)
+      @audiences = SurgeAPI::Resources::Audiences.new(client: self)
       @blasts = SurgeAPI::Resources::Blasts.new(client: self)
       @campaigns = SurgeAPI::Resources::Campaigns.new(client: self)
       @contacts = SurgeAPI::Resources::Contacts.new(client: self)

data/lib/surge_api/internal/cursor.rb

@@ -10,8 +10,8 @@ module SurgeAPI
     #   end
     #
     # @example
-    #   cursor.auto_paging_each do |campaign|
-    #     puts(campaign)
+    #   cursor.auto_paging_each do |audience|
+    #     puts(audience)
     #   end
     class Cursor
       include SurgeAPI::Internal::Type::BasePage

data/lib/surge_api/models/account_create_params.rb

@@ -88,15 +88,15 @@ module SurgeAPI
 
         # @!attribute identifier
         #   The value of the identifier whose type is specified in the identifier_type
-        #   field. Typically this will be an EIN, and can be formatted with or without the
-        #   hyphen.
+        #   field. For EIN, can be formatted with or without the hyphen. For CBN, must be
+        #   exactly 9 digits.
         #
         #   @return [String, nil]
         optional :identifier, String, nil?: true
 
         # @!attribute identifier_type
-        #   The type of identifier being provided for the organization. Support for more
-        #   values will be added in the future.
+        #   The type of identifier being provided for the organization. Use "ein" for US
+        #   businesses or "cbn" for Canadian businesses.
         #
         #   @return [Symbol, SurgeAPI::Models::AccountCreateParams::Organization::IdentifierType, nil]
         optional :identifier_type,
@@ -110,8 +110,8 @@ module SurgeAPI
         optional :industry, enum: -> { SurgeAPI::AccountCreateParams::Organization::Industry }, nil?: true
 
         # @!attribute mobile_number
-        #   For sole proprietors, this must be a valid US mobile phone number to which a
-        #   verification text message will be sent. (E.164 format)
+        #   For sole proprietors, this must be a valid US or Canadian mobile phone number to
+        #   which a verification text message will be sent. (E.164 format)
         #
         #   @return [String, nil]
         optional :mobile_number, String, nil?: true
@@ -180,11 +180,11 @@ module SurgeAPI
         #
         #   @param identifier [String, nil] The value of the identifier whose type is specified in the identifier_type field
         #
-        #   @param identifier_type [Symbol, SurgeAPI::Models::AccountCreateParams::Organization::IdentifierType, nil] The type of identifier being provided for the organization. Support for more val
+        #   @param identifier_type [Symbol, SurgeAPI::Models::AccountCreateParams::Organization::IdentifierType, nil] The type of identifier being provided for the organization. Use "ein" for US bus
         #
         #   @param industry [Symbol, SurgeAPI::Models::AccountCreateParams::Organization::Industry, nil] The industry in which the organization operates.
         #
-        #   @param mobile_number [String, nil] For sole proprietors, this must be a valid US mobile phone number to which a ver
+        #   @param mobile_number [String, nil] For sole proprietors, this must be a valid US or Canadian mobile phone number to
         #
         #   @param regions_of_operation [Array<Symbol, SurgeAPI::Models::AccountCreateParams::Organization::RegionsOfOperation>, nil] An array of regions in which the organization operates.
         #
@@ -354,14 +354,15 @@ module SurgeAPI
           end
         end
 
-        # The type of identifier being provided for the organization. Support for more
-        # values will be added in the future.
+        # The type of identifier being provided for the organization. Use "ein" for US
+        # businesses or "cbn" for Canadian businesses.
         #
         # @see SurgeAPI::Models::AccountCreateParams::Organization#identifier_type
         module IdentifierType
           extend SurgeAPI::Internal::Type::Enum
 
           EIN = :ein
+          CBN = :cbn
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/surge_api/models/account_update_params.rb

@@ -87,15 +87,15 @@ module SurgeAPI
 
         # @!attribute identifier
         #   The value of the identifier whose type is specified in the identifier_type
-        #   field. Typically this will be an EIN, and can be formatted with or without the
-        #   hyphen.
+        #   field. For EIN, can be formatted with or without the hyphen. For CBN, must be
+        #   exactly 9 digits.
         #
         #   @return [String, nil]
         optional :identifier, String, nil?: true
 
         # @!attribute identifier_type
-        #   The type of identifier being provided for the organization. Support for more
-        #   values will be added in the future.
+        #   The type of identifier being provided for the organization. Use "ein" for US
+        #   businesses or "cbn" for Canadian businesses.
         #
         #   @return [Symbol, SurgeAPI::Models::AccountUpdateParams::Organization::IdentifierType, nil]
         optional :identifier_type,
@@ -109,8 +109,8 @@ module SurgeAPI
         optional :industry, enum: -> { SurgeAPI::AccountUpdateParams::Organization::Industry }, nil?: true
 
         # @!attribute mobile_number
-        #   For sole proprietors, this must be a valid US mobile phone number to which a
-        #   verification text message will be sent. (E.164 format)
+        #   For sole proprietors, this must be a valid US or Canadian mobile phone number to
+        #   which a verification text message will be sent. (E.164 format)
         #
         #   @return [String, nil]
         optional :mobile_number, String, nil?: true
@@ -179,11 +179,11 @@ module SurgeAPI
         #
         #   @param identifier [String, nil] The value of the identifier whose type is specified in the identifier_type field
         #
-        #   @param identifier_type [Symbol, SurgeAPI::Models::AccountUpdateParams::Organization::IdentifierType, nil] The type of identifier being provided for the organization. Support for more val
+        #   @param identifier_type [Symbol, SurgeAPI::Models::AccountUpdateParams::Organization::IdentifierType, nil] The type of identifier being provided for the organization. Use "ein" for US bus
         #
         #   @param industry [Symbol, SurgeAPI::Models::AccountUpdateParams::Organization::Industry, nil] The industry in which the organization operates.
         #
-        #   @param mobile_number [String, nil] For sole proprietors, this must be a valid US mobile phone number to which a ver
+        #   @param mobile_number [String, nil] For sole proprietors, this must be a valid US or Canadian mobile phone number to
         #
         #   @param regions_of_operation [Array<Symbol, SurgeAPI::Models::AccountUpdateParams::Organization::RegionsOfOperation>, nil] An array of regions in which the organization operates.
         #
@@ -353,14 +353,15 @@ module SurgeAPI
           end
         end
 
-        # The type of identifier being provided for the organization. Support for more
-        # values will be added in the future.
+        # The type of identifier being provided for the organization. Use "ein" for US
+        # businesses or "cbn" for Canadian businesses.
         #
         # @see SurgeAPI::Models::AccountUpdateParams::Organization#identifier_type
         module IdentifierType
           extend SurgeAPI::Internal::Type::Enum
 
           EIN = :ein
+          CBN = :cbn
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/surge_api/models/audience_add_contact_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Audiences#add_contact
+    class AudienceAddContactParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #   The ID of the contact to add. The contact must belong to the same account as the
+      #   audience.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {SurgeAPI::Models::AudienceAddContactParams} for more details.
+      #
+      #   @param id [String] The ID of the contact to add. The contact must belong to the same account as the
+      #
+      #   @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/surge_api/models/audience_list_contacts_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    # @see SurgeAPI::Resources::Audiences#list_contacts
+    class AudienceListContactsParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      # @!attribute after
+      #   Cursor for forward pagination. Use the next_cursor from a previous response.
+      #
+      #   @return [String, nil]
+      optional :after, String
+
+      # @!attribute before
+      #   Cursor for backward pagination. Use the previous_cursor from a previous
+      #   response.
+      #
+      #   @return [String, nil]
+      optional :before, String
+
+      # @!method initialize(after: nil, before: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {SurgeAPI::Models::AudienceListContactsParams} for more details.
+      #
+      #   @param after [String] Cursor for forward pagination. Use the next_cursor from a previous response.
+      #
+      #   @param before [String] Cursor for backward pagination. Use the previous_cursor from a previous response
+      #
+      #   @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/surge_api/models/organization.rb

@@ -35,15 +35,15 @@ module SurgeAPI
 
       # @!attribute identifier
       #   The value of the identifier whose type is specified in the identifier_type
-      #   field. Typically this will be an EIN, and can be formatted with or without the
-      #   hyphen.
+      #   field. For EIN, can be formatted with or without the hyphen. For CBN, must be
+      #   exactly 9 digits.
       #
       #   @return [String, nil]
       required :identifier, String, nil?: true
 
       # @!attribute identifier_type
-      #   The type of identifier being provided for the organization. Support for more
-      #   values will be added in the future.
+      #   The type of identifier being provided for the organization. Use "ein" for US
+      #   businesses or "cbn" for Canadian businesses.
       #
       #   @return [Symbol, SurgeAPI::Models::Organization::IdentifierType, nil]
       required :identifier_type, enum: -> { SurgeAPI::Organization::IdentifierType }, nil?: true
@@ -55,8 +55,8 @@ module SurgeAPI
       required :industry, enum: -> { SurgeAPI::Organization::Industry }, nil?: true
 
       # @!attribute mobile_number
-      #   For sole proprietors, this must be a valid US mobile phone number to which a
-      #   verification text message will be sent. (E.164 format)
+      #   For sole proprietors, this must be a valid US or Canadian mobile phone number to
+      #   which a verification text message will be sent. (E.164 format)
       #
       #   @return [String, nil]
       required :mobile_number, String, nil?: true
@@ -120,11 +120,11 @@ module SurgeAPI
       #
       #   @param identifier [String, nil] The value of the identifier whose type is specified in the identifier_type field
       #
-      #   @param identifier_type [Symbol, SurgeAPI::Models::Organization::IdentifierType, nil] The type of identifier being provided for the organization. Support for more val
+      #   @param identifier_type [Symbol, SurgeAPI::Models::Organization::IdentifierType, nil] The type of identifier being provided for the organization. Use "ein" for US bus
       #
       #   @param industry [Symbol, SurgeAPI::Models::Organization::Industry, nil] The industry in which the organization operates.
       #
-      #   @param mobile_number [String, nil] For sole proprietors, this must be a valid US mobile phone number to which a ver
+      #   @param mobile_number [String, nil] For sole proprietors, this must be a valid US or Canadian mobile phone number to
       #
       #   @param regions_of_operation [Array<Symbol, SurgeAPI::Models::Organization::RegionsOfOperation>, nil] An array of regions in which the organization operates.
       #
@@ -286,14 +286,15 @@ module SurgeAPI
         end
       end
 
-      # The type of identifier being provided for the organization. Support for more
-      # values will be added in the future.
+      # The type of identifier being provided for the organization. Use "ein" for US
+      # businesses or "cbn" for Canadian businesses.
       #
       # @see SurgeAPI::Models::Organization#identifier_type
       module IdentifierType
         extend SurgeAPI::Internal::Type::Enum
 
         EIN = :ein
+        CBN = :cbn
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/surge_api/models.rb

@@ -51,6 +51,10 @@ module SurgeAPI
 
   AccountUpdateParams = SurgeAPI::Models::AccountUpdateParams
 
+  AudienceAddContactParams = SurgeAPI::Models::AudienceAddContactParams
+
+  AudienceListContactsParams = SurgeAPI::Models::AudienceListContactsParams
+
   Blast = SurgeAPI::Models::Blast
 
   BlastCreateParams = SurgeAPI::Models::BlastCreateParams

data/lib/surge_api/resources/audiences.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Resources
+    class Audiences
+      # Some parameter documentations has been truncated, see
+      # {SurgeAPI::Models::AudienceAddContactParams} for more details.
+      #
+      # Adds an existing contact to a manual audience.
+      #
+      # @overload add_contact(audience_id, id:, request_options: {})
+      #
+      # @param audience_id [String] The audience ID to add the contact to.
+      #
+      # @param id [String] The ID of the contact to add. The contact must belong to the same account as the
+      #
+      # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SurgeAPI::Models::Contact]
+      #
+      # @see SurgeAPI::Models::AudienceAddContactParams
+      def add_contact(audience_id, params)
+        parsed, options = SurgeAPI::AudienceAddContactParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["audiences/%1$s/contacts", audience_id],
+          body: parsed,
+          model: SurgeAPI::Contact,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {SurgeAPI::Models::AudienceListContactsParams} for more details.
+      #
+      # List all contacts in an audience with cursor-based pagination. The account is
+      # inferred from the audience.
+      #
+      # @overload list_contacts(audience_id, after: nil, before: nil, request_options: {})
+      #
+      # @param audience_id [String] The audience ID to list contacts for.
+      #
+      # @param after [String] Cursor for forward pagination. Use the next_cursor from a previous response.
+      #
+      # @param before [String] Cursor for backward pagination. Use the previous_cursor from a previous response
+      #
+      # @param request_options [SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SurgeAPI::Internal::Cursor<SurgeAPI::Models::Contact>]
+      #
+      # @see SurgeAPI::Models::AudienceListContactsParams
+      def list_contacts(audience_id, params = {})
+        parsed, options = SurgeAPI::AudienceListContactsParams.dump_request(params)
+        query = SurgeAPI::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["audiences/%1$s/contacts", audience_id],
+          query: query,
+          page: SurgeAPI::Internal::Cursor,
+          model: SurgeAPI::Contact,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [SurgeAPI::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/surge_api/version.rb

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

data/lib/surge_api.rb

@@ -61,6 +61,8 @@ require_relative "surge_api/models/account_create_params"
 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_list_contacts_params"
 require_relative "surge_api/models/blast"
 require_relative "surge_api/models/blast_create_params"
 require_relative "surge_api/models/call_ended_webhook_event"
@@ -118,6 +120,7 @@ require_relative "surge_api/models/voicemail_received_webhook_event"
 require_relative "surge_api/models/webhook_unwrap_params"
 require_relative "surge_api/models"
 require_relative "surge_api/resources/accounts"
+require_relative "surge_api/resources/audiences"
 require_relative "surge_api/resources/blasts"
 require_relative "surge_api/resources/campaigns"
 require_relative "surge_api/resources/contacts"

data/rbi/surge_api/client.rbi

@@ -16,6 +16,9 @@ module SurgeAPI
     sig { returns(SurgeAPI::Resources::Accounts) }
     attr_reader :accounts
 
+    sig { returns(SurgeAPI::Resources::Audiences) }
+    attr_reader :audiences
+
     sig { returns(SurgeAPI::Resources::Blasts) }
     attr_reader :blasts
 

data/rbi/surge_api/models/account_create_params.rbi

@@ -148,13 +148,13 @@ module SurgeAPI
         attr_accessor :email
 
         # The value of the identifier whose type is specified in the identifier_type
-        # field. Typically this will be an EIN, and can be formatted with or without the
-        # hyphen.
+        # field. For EIN, can be formatted with or without the hyphen. For CBN, must be
+        # exactly 9 digits.
         sig { returns(T.nilable(String)) }
         attr_accessor :identifier
 
-        # The type of identifier being provided for the organization. Support for more
-        # values will be added in the future.
+        # The type of identifier being provided for the organization. Use "ein" for US
+        # businesses or "cbn" for Canadian businesses.
         sig do
           returns(
             T.nilable(
@@ -174,8 +174,8 @@ module SurgeAPI
         end
         attr_accessor :industry
 
-        # For sole proprietors, this must be a valid US mobile phone number to which a
-        # verification text message will be sent. (E.164 format)
+        # For sole proprietors, this must be a valid US or Canadian mobile phone number to
+        # which a verification text message will be sent. (E.164 format)
         sig { returns(T.nilable(String)) }
         attr_accessor :mobile_number
 
@@ -288,16 +288,16 @@ module SurgeAPI
           # `@dtprecisionauto.com`)
           email: nil,
           # The value of the identifier whose type is specified in the identifier_type
-          # field. Typically this will be an EIN, and can be formatted with or without the
-          # hyphen.
+          # field. For EIN, can be formatted with or without the hyphen. For CBN, must be
+          # exactly 9 digits.
           identifier: nil,
-          # The type of identifier being provided for the organization. Support for more
-          # values will be added in the future.
+          # The type of identifier being provided for the organization. Use "ein" for US
+          # businesses or "cbn" for Canadian businesses.
           identifier_type: nil,
           # The industry in which the organization operates.
           industry: nil,
-          # For sole proprietors, this must be a valid US mobile phone number to which a
-          # verification text message will be sent. (E.164 format)
+          # For sole proprietors, this must be a valid US or Canadian mobile phone number to
+          # which a verification text message will be sent. (E.164 format)
           mobile_number: nil,
           # An array of regions in which the organization operates.
           regions_of_operation: nil,
@@ -612,8 +612,8 @@ module SurgeAPI
           end
         end
 
-        # The type of identifier being provided for the organization. Support for more
-        # values will be added in the future.
+        # The type of identifier being provided for the organization. Use "ein" for US
+        # businesses or "cbn" for Canadian businesses.
         module IdentifierType
           extend SurgeAPI::Internal::Type::Enum
 
@@ -631,6 +631,11 @@ module SurgeAPI
               :ein,
               SurgeAPI::AccountCreateParams::Organization::IdentifierType::TaggedSymbol
             )
+          CBN =
+            T.let(
+              :cbn,
+              SurgeAPI::AccountCreateParams::Organization::IdentifierType::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/surge_api/models/account_update_params.rbi

@@ -149,13 +149,13 @@ module SurgeAPI
         attr_accessor :email
 
         # The value of the identifier whose type is specified in the identifier_type
-        # field. Typically this will be an EIN, and can be formatted with or without the
-        # hyphen.
+        # field. For EIN, can be formatted with or without the hyphen. For CBN, must be
+        # exactly 9 digits.
         sig { returns(T.nilable(String)) }
         attr_accessor :identifier
 
-        # The type of identifier being provided for the organization. Support for more
-        # values will be added in the future.
+        # The type of identifier being provided for the organization. Use "ein" for US
+        # businesses or "cbn" for Canadian businesses.
         sig do
           returns(
             T.nilable(
@@ -175,8 +175,8 @@ module SurgeAPI
         end
         attr_accessor :industry
 
-        # For sole proprietors, this must be a valid US mobile phone number to which a
-        # verification text message will be sent. (E.164 format)
+        # For sole proprietors, this must be a valid US or Canadian mobile phone number to
+        # which a verification text message will be sent. (E.164 format)
         sig { returns(T.nilable(String)) }
         attr_accessor :mobile_number
 
@@ -289,16 +289,16 @@ module SurgeAPI
           # `@dtprecisionauto.com`)
           email: nil,
           # The value of the identifier whose type is specified in the identifier_type
-          # field. Typically this will be an EIN, and can be formatted with or without the
-          # hyphen.
+          # field. For EIN, can be formatted with or without the hyphen. For CBN, must be
+          # exactly 9 digits.
           identifier: nil,
-          # The type of identifier being provided for the organization. Support for more
-          # values will be added in the future.
+          # The type of identifier being provided for the organization. Use "ein" for US
+          # businesses or "cbn" for Canadian businesses.
           identifier_type: nil,
           # The industry in which the organization operates.
           industry: nil,
-          # For sole proprietors, this must be a valid US mobile phone number to which a
-          # verification text message will be sent. (E.164 format)
+          # For sole proprietors, this must be a valid US or Canadian mobile phone number to
+          # which a verification text message will be sent. (E.164 format)
           mobile_number: nil,
           # An array of regions in which the organization operates.
           regions_of_operation: nil,
@@ -613,8 +613,8 @@ module SurgeAPI
           end
         end
 
-        # The type of identifier being provided for the organization. Support for more
-        # values will be added in the future.
+        # The type of identifier being provided for the organization. Use "ein" for US
+        # businesses or "cbn" for Canadian businesses.
         module IdentifierType
           extend SurgeAPI::Internal::Type::Enum
 
@@ -632,6 +632,11 @@ module SurgeAPI
               :ein,
               SurgeAPI::AccountUpdateParams::Organization::IdentifierType::TaggedSymbol
             )
+          CBN =
+            T.let(
+              :cbn,
+              SurgeAPI::AccountUpdateParams::Organization::IdentifierType::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/surge_api/models/audience_add_contact_params.rbi

@@ -0,0 +1,42 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class AudienceAddContactParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(SurgeAPI::AudienceAddContactParams, SurgeAPI::Internal::AnyHash)
+        end
+
+      # The ID of the contact to add. The contact must belong to the same account as the
+      # audience.
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig do
+        params(
+          id: String,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The ID of the contact to add. The contact must belong to the same account as the
+        # audience.
+        id:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          { id: String, request_options: SurgeAPI::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/surge_api/models/audience_list_contacts_params.rbi

@@ -0,0 +1,62 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class AudienceListContactsParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            SurgeAPI::AudienceListContactsParams,
+            SurgeAPI::Internal::AnyHash
+          )
+        end
+
+      # Cursor for forward pagination. Use the next_cursor from a previous response.
+      sig { returns(T.nilable(String)) }
+      attr_reader :after
+
+      sig { params(after: String).void }
+      attr_writer :after
+
+      # Cursor for backward pagination. Use the previous_cursor from a previous
+      # response.
+      sig { returns(T.nilable(String)) }
+      attr_reader :before
+
+      sig { params(before: String).void }
+      attr_writer :before
+
+      sig do
+        params(
+          after: String,
+          before: String,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Cursor for forward pagination. Use the next_cursor from a previous response.
+        after: nil,
+        # Cursor for backward pagination. Use the previous_cursor from a previous
+        # response.
+        before: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            after: String,
+            before: String,
+            request_options: SurgeAPI::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/surge_api/models/organization.rbi

@@ -37,13 +37,13 @@ module SurgeAPI
       attr_accessor :email
 
       # The value of the identifier whose type is specified in the identifier_type
-      # field. Typically this will be an EIN, and can be formatted with or without the
-      # hyphen.
+      # field. For EIN, can be formatted with or without the hyphen. For CBN, must be
+      # exactly 9 digits.
       sig { returns(T.nilable(String)) }
       attr_accessor :identifier
 
-      # The type of identifier being provided for the organization. Support for more
-      # values will be added in the future.
+      # The type of identifier being provided for the organization. Use "ein" for US
+      # businesses or "cbn" for Canadian businesses.
       sig do
         returns(T.nilable(SurgeAPI::Organization::IdentifierType::TaggedSymbol))
       end
@@ -53,8 +53,8 @@ module SurgeAPI
       sig { returns(T.nilable(SurgeAPI::Organization::Industry::TaggedSymbol)) }
       attr_accessor :industry
 
-      # For sole proprietors, this must be a valid US mobile phone number to which a
-      # verification text message will be sent. (E.164 format)
+      # For sole proprietors, this must be a valid US or Canadian mobile phone number to
+      # which a verification text message will be sent. (E.164 format)
       sig { returns(T.nilable(String)) }
       attr_accessor :mobile_number
 
@@ -135,16 +135,16 @@ module SurgeAPI
         # `@dtprecisionauto.com`)
         email:,
         # The value of the identifier whose type is specified in the identifier_type
-        # field. Typically this will be an EIN, and can be formatted with or without the
-        # hyphen.
+        # field. For EIN, can be formatted with or without the hyphen. For CBN, must be
+        # exactly 9 digits.
         identifier:,
-        # The type of identifier being provided for the organization. Support for more
-        # values will be added in the future.
+        # The type of identifier being provided for the organization. Use "ein" for US
+        # businesses or "cbn" for Canadian businesses.
         identifier_type:,
         # The industry in which the organization operates.
         industry:,
-        # For sole proprietors, this must be a valid US mobile phone number to which a
-        # verification text message will be sent. (E.164 format)
+        # For sole proprietors, this must be a valid US or Canadian mobile phone number to
+        # which a verification text message will be sent. (E.164 format)
         mobile_number:,
         # An array of regions in which the organization operates.
         regions_of_operation:,
@@ -408,8 +408,8 @@ module SurgeAPI
         end
       end
 
-      # The type of identifier being provided for the organization. Support for more
-      # values will be added in the future.
+      # The type of identifier being provided for the organization. Use "ein" for US
+      # businesses or "cbn" for Canadian businesses.
       module IdentifierType
         extend SurgeAPI::Internal::Type::Enum
 
@@ -418,6 +418,7 @@ module SurgeAPI
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         EIN = T.let(:ein, SurgeAPI::Organization::IdentifierType::TaggedSymbol)
+        CBN = T.let(:cbn, SurgeAPI::Organization::IdentifierType::TaggedSymbol)
 
         sig do
           override.returns(

data/rbi/surge_api/models.rbi

@@ -13,6 +13,10 @@ module SurgeAPI
 
   AccountUpdateParams = SurgeAPI::Models::AccountUpdateParams
 
+  AudienceAddContactParams = SurgeAPI::Models::AudienceAddContactParams
+
+  AudienceListContactsParams = SurgeAPI::Models::AudienceListContactsParams
+
   Blast = SurgeAPI::Models::Blast
 
   BlastCreateParams = SurgeAPI::Models::BlastCreateParams

data/rbi/surge_api/resources/audiences.rbi

@@ -0,0 +1,52 @@
+# typed: strong
+
+module SurgeAPI
+  module Resources
+    class Audiences
+      # Adds an existing contact to a manual audience.
+      sig do
+        params(
+          audience_id: String,
+          id: String,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(SurgeAPI::Contact)
+      end
+      def add_contact(
+        # The audience ID to add the contact to.
+        audience_id,
+        # The ID of the contact to add. The contact must belong to the same account as the
+        # audience.
+        id:,
+        request_options: {}
+      )
+      end
+
+      # List all contacts in an audience with cursor-based pagination. The account is
+      # inferred from the audience.
+      sig do
+        params(
+          audience_id: String,
+          after: String,
+          before: String,
+          request_options: SurgeAPI::RequestOptions::OrHash
+        ).returns(SurgeAPI::Internal::Cursor[SurgeAPI::Contact])
+      end
+      def list_contacts(
+        # The audience ID to list contacts for.
+        audience_id,
+        # Cursor for forward pagination. Use the next_cursor from a previous response.
+        after: nil,
+        # Cursor for backward pagination. Use the previous_cursor from a previous
+        # response.
+        before: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: SurgeAPI::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/sig/surge_api/client.rbs

@@ -12,6 +12,8 @@ module SurgeAPI
 
     attr_reader accounts: SurgeAPI::Resources::Accounts
 
+    attr_reader audiences: SurgeAPI::Resources::Audiences
+
     attr_reader blasts: SurgeAPI::Resources::Blasts
 
     attr_reader campaigns: SurgeAPI::Resources::Campaigns

data/sig/surge_api/models/account_create_params.rbs

@@ -234,12 +234,13 @@ module SurgeAPI
           end
         end
 
-        type identifier_type = :ein
+        type identifier_type = :ein | :cbn
 
         module IdentifierType
           extend SurgeAPI::Internal::Type::Enum
 
           EIN: :ein
+          CBN: :cbn
 
           def self?.values: -> ::Array[SurgeAPI::Models::AccountCreateParams::Organization::identifier_type]
         end

data/sig/surge_api/models/account_update_params.rbs

@@ -236,12 +236,13 @@ module SurgeAPI
           end
         end
 
-        type identifier_type = :ein
+        type identifier_type = :ein | :cbn
 
         module IdentifierType
           extend SurgeAPI::Internal::Type::Enum
 
           EIN: :ein
+          CBN: :cbn
 
           def self?.values: -> ::Array[SurgeAPI::Models::AccountUpdateParams::Organization::identifier_type]
         end

data/sig/surge_api/models/audience_add_contact_params.rbs

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

data/sig/surge_api/models/audience_list_contacts_params.rbs

@@ -0,0 +1,32 @@
+module SurgeAPI
+  module Models
+    type audience_list_contacts_params =
+      { after: String, before: String }
+      & SurgeAPI::Internal::Type::request_parameters
+
+    class AudienceListContactsParams < SurgeAPI::Internal::Type::BaseModel
+      extend SurgeAPI::Internal::Type::RequestParameters::Converter
+      include SurgeAPI::Internal::Type::RequestParameters
+
+      attr_reader after: String?
+
+      def after=: (String) -> String
+
+      attr_reader before: String?
+
+      def before=: (String) -> String
+
+      def initialize: (
+        ?after: String,
+        ?before: String,
+        ?request_options: SurgeAPI::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        after: String,
+        before: String,
+        request_options: SurgeAPI::RequestOptions
+      }
+    end
+  end
+end

data/sig/surge_api/models/organization.rbs

@@ -187,12 +187,13 @@ module SurgeAPI
         end
       end
 
-      type identifier_type = :ein
+      type identifier_type = :ein | :cbn
 
       module IdentifierType
         extend SurgeAPI::Internal::Type::Enum
 
         EIN: :ein
+        CBN: :cbn
 
         def self?.values: -> ::Array[SurgeAPI::Models::Organization::identifier_type]
       end

data/sig/surge_api/models.rbs

@@ -11,6 +11,10 @@ module SurgeAPI
 
   class AccountUpdateParams = SurgeAPI::Models::AccountUpdateParams
 
+  class AudienceAddContactParams = SurgeAPI::Models::AudienceAddContactParams
+
+  class AudienceListContactsParams = SurgeAPI::Models::AudienceListContactsParams
+
   class Blast = SurgeAPI::Models::Blast
 
   class BlastCreateParams = SurgeAPI::Models::BlastCreateParams

data/sig/surge_api/resources/audiences.rbs

@@ -0,0 +1,20 @@
+module SurgeAPI
+  module Resources
+    class Audiences
+      def add_contact: (
+        String audience_id,
+        id: String,
+        ?request_options: SurgeAPI::request_opts
+      ) -> SurgeAPI::Contact
+
+      def list_contacts: (
+        String audience_id,
+        ?after: String,
+        ?before: String,
+        ?request_options: SurgeAPI::request_opts
+      ) -> SurgeAPI::Internal::Cursor[SurgeAPI::Contact]
+
+      def initialize: (client: SurgeAPI::Client) -> void
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: surge_api
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Surge
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-24 00:00:00.000000000 Z
+date: 2026-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -76,6 +76,8 @@ files:
 - lib/surge_api/models/account_retrieve_status_params.rb
 - 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_list_contacts_params.rb
 - lib/surge_api/models/blast.rb
 - lib/surge_api/models/blast_create_params.rb
 - lib/surge_api/models/call_ended_webhook_event.rb
@@ -135,6 +137,7 @@ files:
 - lib/surge_api/models/webhook_unwrap_params.rb
 - lib/surge_api/request_options.rb
 - lib/surge_api/resources/accounts.rb
+- lib/surge_api/resources/audiences.rb
 - lib/surge_api/resources/blasts.rb
 - lib/surge_api/resources/campaigns.rb
 - lib/surge_api/resources/contacts.rb
@@ -172,6 +175,8 @@ files:
 - rbi/surge_api/models/account_retrieve_status_params.rbi
 - 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_list_contacts_params.rbi
 - rbi/surge_api/models/blast.rbi
 - rbi/surge_api/models/blast_create_params.rbi
 - rbi/surge_api/models/call_ended_webhook_event.rbi
@@ -231,6 +236,7 @@ files:
 - rbi/surge_api/models/webhook_unwrap_params.rbi
 - rbi/surge_api/request_options.rbi
 - rbi/surge_api/resources/accounts.rbi
+- rbi/surge_api/resources/audiences.rbi
 - rbi/surge_api/resources/blasts.rbi
 - rbi/surge_api/resources/campaigns.rbi
 - rbi/surge_api/resources/contacts.rbi
@@ -267,6 +273,8 @@ files:
 - sig/surge_api/models/account_retrieve_status_params.rbs
 - 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_list_contacts_params.rbs
 - sig/surge_api/models/blast.rbs
 - sig/surge_api/models/blast_create_params.rbs
 - sig/surge_api/models/call_ended_webhook_event.rbs
@@ -326,6 +334,7 @@ files:
 - sig/surge_api/models/webhook_unwrap_params.rbs
 - sig/surge_api/request_options.rbs
 - sig/surge_api/resources/accounts.rbs
+- sig/surge_api/resources/audiences.rbs
 - sig/surge_api/resources/blasts.rbs
 - sig/surge_api/resources/campaigns.rbs
 - sig/surge_api/resources/contacts.rbs