surge_api 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21d19ad8088d287a26c0293ecbec97d29a879616d98b219dbcb8c672c699f58d
-  data.tar.gz: eb81ac34997ec986242cdd64006a69d31f7bb76555a8a711644fcc06210c1293
+  metadata.gz: 8012d35d6b7aaae2d18541e688d7605e1ee985153b70ebec72790ddb0ba3b28b
+  data.tar.gz: 7051be5e16f4e06b7eafac3c3b8b7554fc06710c5b6a0104e8f4dabe6ba8f448
 SHA512:
-  metadata.gz: af5bc8ed33052eb78f9a1bcb9e165e594f2b684891c6a159315903847da918c38ce1a4b8cb60bdb10b5cc4d144eb1a7398f816c90606268189408f9da6de25d0
-  data.tar.gz: 17951922f214b0a5d290fd520658d9964ae51972e5761199272d3193a91bfa3f2b52cc1fa749f4235174d42733472d732b2c20a4dd6767509b5b89b06e86d82b
+  metadata.gz: 50cb8dd9f5162634bb262e93eda01ed24d9af0d8c0c45171d4642969e7824292cea2465ef00d199a85e62e0ad7a38288ed082c44f7a529210c13802e0cfbcf77
+  data.tar.gz: 4b0d24f6c73cfb6b038ac5c9663cbf2c83917770eff0f3d0d36fe9006cfc2adf80892f9c65b693380f3f9e671362af3e2ef93a1cb5743dc3d39e935d57ed12ed

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.12.0 (2026-03-11)
+
+Full Changelog: [v0.11.0...v0.12.0](https://github.com/surgeapi/ruby-sdk/compare/v0.11.0...v0.12.0)
+
+### Features
+
+* **api:** add campaign ID to phone numbers ([76e02a6](https://github.com/surgeapi/ruby-sdk/commit/76e02a67b248539548b0bc918178dcb9749ef2aa))
+* **api:** add phoneNumberAttachedToCampaign webhook ([b145691](https://github.com/surgeapi/ruby-sdk/commit/b14569150ea04fd2d74f9f17ff0ab3bbf00d9c19))
+* **api:** remove 'pending' campaign status ([067f38a](https://github.com/surgeapi/ruby-sdk/commit/067f38adf747327111ad032362f5e9faf31dddce))
+* **api:** rename segments to audiences ([69c982c](https://github.com/surgeapi/ruby-sdk/commit/69c982c90af4999babdff64a46ffe5df1d54391a))
+
+
+### Bug Fixes
+
+* properly mock time in ruby ci tests ([6c75ef3](https://github.com/surgeapi/ruby-sdk/commit/6c75ef31490dc13fb591146b2b27a8a3c8f3495c))
+
+
+### Chores
+
+* **ci:** add build step ([4999f0c](https://github.com/surgeapi/ruby-sdk/commit/4999f0c610b73f42d468fc200aeafe002f4947b0))
+* **internal:** codegen related update ([bd1d5f0](https://github.com/surgeapi/ruby-sdk/commit/bd1d5f019b6ec12acdca6e36af2c46065dab0e70))
+
 ## 0.11.0 (2026-02-22)
 
 Full Changelog: [v0.10.0...v0.11.0](https://github.com/surgeapi/ruby-sdk/compare/v0.10.0...v0.11.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.11.0"
+gem "surge_api", "~> 0.12.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/surge_api/internal/util.rb

@@ -490,6 +490,37 @@ module SurgeAPI
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
+        # @api private
+        #
+        # @param query [Hash{Symbol=>Object}]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def encode_query_params(query)
+          out = {}
+          query.each { write_query_param_element!(out, _1, _2) }
+          out
+        end
+
+        # @api private
+        #
+        # @param collection [Hash{Symbol=>Object}]
+        # @param key [String]
+        # @param element [Object]
+        #
+        # @return [nil]
+        private def write_query_param_element!(collection, key, element)
+          case element
+          in Hash
+            element.each do |name, value|
+              write_query_param_element!(collection, "#{key}[#{name}]", value)
+            end
+          in Array
+            collection[key] = element.map(&:to_s).join(",")
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]

data/lib/surge_api/models/blast_create_params.rb

@@ -41,9 +41,9 @@ module SurgeAPI
       optional :name, String
 
       # @!attribute segments
-      #   @deprecated Use `to` to specify recipients instead.
+      #   @deprecated Use `to` with audience IDs (`aud_...`) to specify audience recipients instead.
       #
-      #   Deprecated. Use `to` instead.
+      #   Deprecated. Use `to` with audience IDs instead.
       #
       #   @return [Array<String>, nil]
       optional :segments, SurgeAPI::Internal::Type::ArrayOf[String]
@@ -56,7 +56,7 @@ module SurgeAPI
 
       # @!attribute to
       #   List of recipients to whom the blast should be sent. This can be a combination
-      #   of contact IDs, segment IDs, and phone numbers.
+      #   of contact IDs, audience IDs, and phone numbers.
       #
       #   @return [Array<String>, nil]
       optional :to, SurgeAPI::Internal::Type::ArrayOf[String]
@@ -75,7 +75,7 @@ module SurgeAPI
       #
       #   @param name [String] Optional name for the blast.
       #
-      #   @param segments [Array<String>] Deprecated. Use `to` instead.
+      #   @param segments [Array<String>] Deprecated. Use `to` with audience IDs instead.
       #
       #   @param send_at [Time] When to send the blast. If not provided, sends immediately.
       #

data/lib/surge_api/models/campaign.rb

@@ -183,7 +183,6 @@ module SurgeAPI
         CREATED = :created
         DEACTIVATED = :deactivated
         IN_REVIEW = :in_review
-        PENDING = :pending
         REJECTED = :rejected
 
         # @!method self.values

data/lib/surge_api/models/phone_number.rb

@@ -10,6 +10,12 @@ module SurgeAPI
       #   @return [String]
       required :id, String
 
+      # @!attribute campaign_id
+      #   The unique identifier of the campaign this phone number is attached to, if any
+      #
+      #   @return [String, nil]
+      required :campaign_id, String, nil?: true
+
       # @!attribute number
       #   The phone number in E.164 format
       #
@@ -22,11 +28,13 @@ module SurgeAPI
       #   @return [Symbol, SurgeAPI::Models::PhoneNumber::Type]
       required :type, enum: -> { SurgeAPI::PhoneNumber::Type }
 
-      # @!method initialize(id:, number:, type:)
+      # @!method initialize(id:, campaign_id:, number:, type:)
       #   A phone number that can be used to send and receive messages and calls
       #
       #   @param id [String] Unique identifier for the phone number
       #
+      #   @param campaign_id [String, nil] The unique identifier of the campaign this phone number is attached to, if any
+      #
       #   @param number [String] The phone number in E.164 format
       #
       #   @param type [Symbol, SurgeAPI::Models::PhoneNumber::Type] Whether the phone number is local, toll-free, or short code

data/lib/surge_api/models/phone_number_attached_to_campaign_webhook_event.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    class PhoneNumberAttachedToCampaignWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      # @!attribute account_id
+      #   The ID of the account in which this event occurred
+      #
+      #   @return [String]
+      required :account_id, String
+
+      # @!attribute data
+      #   The data associated with the event
+      #
+      #   @return [SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data]
+      required :data, -> { SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data }
+
+      # @!attribute timestamp
+      #   The timestamp when this event occurred, in ISO8601 format
+      #
+      #   @return [Time]
+      required :timestamp, Time
+
+      # @!attribute type
+      #   The type of the event. Always `phone_number.attached_to_campaign` for this
+      #   event.
+      #
+      #   @return [Symbol, :"phone_number.attached_to_campaign"]
+      required :type, const: :"phone_number.attached_to_campaign"
+
+      # @!method initialize(account_id:, data:, timestamp:, type: :"phone_number.attached_to_campaign")
+      #   Some parameter documentations has been truncated, see
+      #   {SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent} for more details.
+      #
+      #   @param account_id [String] The ID of the account in which this event occurred
+      #
+      #   @param data [SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data] The data associated with the event
+      #
+      #   @param timestamp [Time] The timestamp when this event occurred, in ISO8601 format
+      #
+      #   @param type [Symbol, :"phone_number.attached_to_campaign"] The type of the event. Always `phone_number.attached_to_campaign` for this event
+
+      # @see SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent#data
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique identifier for the phone number
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute campaign_id
+        #   The unique identifier of the campaign this phone number is attached to
+        #
+        #   @return [String]
+        required :campaign_id, String
+
+        # @!attribute number
+        #   The phone number in E.164 format
+        #
+        #   @return [String]
+        required :number, String
+
+        # @!attribute type
+        #   Whether the phone number is local, toll-free, or short code
+        #
+        #   @return [Symbol, SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type]
+        required :type, enum: -> { SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type }
+
+        # @!method initialize(id:, campaign_id:, number:, type:)
+        #   The data associated with the event
+        #
+        #   @param id [String] The unique identifier for the phone number
+        #
+        #   @param campaign_id [String] The unique identifier of the campaign this phone number is attached to
+        #
+        #   @param number [String] The phone number in E.164 format
+        #
+        #   @param type [Symbol, SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type] Whether the phone number is local, toll-free, or short code
+
+        # Whether the phone number is local, toll-free, or short code
+        #
+        # @see SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data#type
+        module Type
+          extend SurgeAPI::Internal::Type::Enum
+
+          LOCAL = :local
+          SHORT_CODE = :short_code
+          TOLL_FREE = :toll_free
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/surge_api/models/unwrap_webhook_event.rb

@@ -27,12 +27,14 @@ module SurgeAPI
 
       variant :"message.sent", -> { SurgeAPI::MessageSentWebhookEvent }
 
+      variant :"phone_number.attached_to_campaign", -> { SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent }
+
       variant :"recording.completed", -> { SurgeAPI::RecordingCompletedWebhookEvent }
 
       variant :"voicemail.received", -> { SurgeAPI::VoicemailReceivedWebhookEvent }
 
       # @!method self.variants
-      #   @return [Array(SurgeAPI::Models::CallEndedWebhookEvent, SurgeAPI::Models::CampaignApprovedWebhookEvent, SurgeAPI::Models::ContactOptedInWebhookEvent, SurgeAPI::Models::ContactOptedOutWebhookEvent, SurgeAPI::Models::ConversationCreatedWebhookEvent, SurgeAPI::Models::LinkFollowedWebhookEvent, SurgeAPI::Models::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent, SurgeAPI::Models::RecordingCompletedWebhookEvent, SurgeAPI::Models::VoicemailReceivedWebhookEvent)]
+      #   @return [Array(SurgeAPI::Models::CallEndedWebhookEvent, SurgeAPI::Models::CampaignApprovedWebhookEvent, SurgeAPI::Models::ContactOptedInWebhookEvent, SurgeAPI::Models::ContactOptedOutWebhookEvent, SurgeAPI::Models::ConversationCreatedWebhookEvent, SurgeAPI::Models::LinkFollowedWebhookEvent, SurgeAPI::Models::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent, SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent, SurgeAPI::Models::RecordingCompletedWebhookEvent, SurgeAPI::Models::VoicemailReceivedWebhookEvent)]
     end
   end
 end

data/lib/surge_api/models.rb

@@ -111,6 +111,8 @@ module SurgeAPI
 
   PhoneNumber = SurgeAPI::Models::PhoneNumber
 
+  PhoneNumberAttachedToCampaignWebhookEvent = SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent
+
   PhoneNumberListParams = SurgeAPI::Models::PhoneNumberListParams
 
   PhoneNumberPurchaseParams = SurgeAPI::Models::PhoneNumberPurchaseParams

data/lib/surge_api/resources/accounts.rb

@@ -111,10 +111,11 @@ module SurgeAPI
       # @see SurgeAPI::Models::AccountRetrieveStatusParams
       def retrieve_status(account_id, params = {})
         parsed, options = SurgeAPI::AccountRetrieveStatusParams.dump_request(params)
+        query = SurgeAPI::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["accounts/%1$s/status", account_id],
-          query: parsed,
+          query: query,
           model: SurgeAPI::AccountStatus,
           options: options
         )

data/lib/surge_api/resources/blasts.rb

@@ -22,7 +22,7 @@ module SurgeAPI
       #
       # @param name [String] Optional name for the blast.
       #
-      # @param segments [Array<String>] Deprecated. Use `to` instead.
+      # @param segments [Array<String>] Deprecated. Use `to` with audience IDs instead.
       #
       # @param send_at [Time] When to send the blast. If not provided, sends immediately.
       #

data/lib/surge_api/resources/campaigns.rb

@@ -75,10 +75,11 @@ module SurgeAPI
       # @see SurgeAPI::Models::CampaignListParams
       def list(account_id, params = {})
         parsed, options = SurgeAPI::CampaignListParams.dump_request(params)
+        query = SurgeAPI::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["accounts/%1$s/campaigns", account_id],
-          query: parsed,
+          query: query,
           page: SurgeAPI::Internal::Cursor,
           model: SurgeAPI::Campaign,
           options: options

data/lib/surge_api/resources/contacts.rb

@@ -108,10 +108,11 @@ module SurgeAPI
       # @see SurgeAPI::Models::ContactListParams
       def list(account_id, params = {})
         parsed, options = SurgeAPI::ContactListParams.dump_request(params)
+        query = SurgeAPI::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["accounts/%1$s/contacts", account_id],
-          query: parsed,
+          query: query,
           page: SurgeAPI::Internal::Cursor,
           model: SurgeAPI::Contact,
           options: options

data/lib/surge_api/resources/messages.rb

@@ -99,10 +99,11 @@ module SurgeAPI
       # @see SurgeAPI::Models::MessageListParams
       def list(account_id, params = {})
         parsed, options = SurgeAPI::MessageListParams.dump_request(params)
+        query = SurgeAPI::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["accounts/%1$s/messages", account_id],
-          query: parsed,
+          query: query,
           page: SurgeAPI::Internal::Cursor,
           model: SurgeAPI::Message,
           options: options

data/lib/surge_api/resources/phone_numbers.rb

@@ -23,10 +23,11 @@ module SurgeAPI
       # @see SurgeAPI::Models::PhoneNumberListParams
       def list(account_id, params = {})
         parsed, options = SurgeAPI::PhoneNumberListParams.dump_request(params)
+        query = SurgeAPI::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["accounts/%1$s/phone_numbers", account_id],
-          query: parsed,
+          query: query,
           page: SurgeAPI::Internal::Cursor,
           model: SurgeAPI::PhoneNumber,
           options: options

data/lib/surge_api/resources/webhooks.rb

@@ -5,7 +5,7 @@ module SurgeAPI
     class Webhooks
       # @param payload [String] The raw webhook payload as a string
       #
-      # @return [SurgeAPI::Models::CallEndedWebhookEvent, SurgeAPI::Models::CampaignApprovedWebhookEvent, SurgeAPI::Models::ContactOptedInWebhookEvent, SurgeAPI::Models::ContactOptedOutWebhookEvent, SurgeAPI::Models::ConversationCreatedWebhookEvent, SurgeAPI::Models::LinkFollowedWebhookEvent, SurgeAPI::Models::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent, SurgeAPI::Models::RecordingCompletedWebhookEvent, SurgeAPI::Models::VoicemailReceivedWebhookEvent]
+      # @return [SurgeAPI::Models::CallEndedWebhookEvent, SurgeAPI::Models::CampaignApprovedWebhookEvent, SurgeAPI::Models::ContactOptedInWebhookEvent, SurgeAPI::Models::ContactOptedOutWebhookEvent, SurgeAPI::Models::ConversationCreatedWebhookEvent, SurgeAPI::Models::LinkFollowedWebhookEvent, SurgeAPI::Models::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent, SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent, SurgeAPI::Models::RecordingCompletedWebhookEvent, SurgeAPI::Models::VoicemailReceivedWebhookEvent]
       def unwrap(payload)
         parsed = JSON.parse(payload, symbolize_names: true)
         SurgeAPI::Internal::Type::Converter.coerce(SurgeAPI::Models::UnwrapWebhookEvent, parsed)

data/lib/surge_api/version.rb

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

data/lib/surge_api.rb

@@ -89,6 +89,7 @@ require_relative "surge_api/models/message_retrieve_params"
 require_relative "surge_api/models/message_sent_webhook_event"
 require_relative "surge_api/models/organization"
 require_relative "surge_api/models/phone_number"
+require_relative "surge_api/models/phone_number_attached_to_campaign_webhook_event"
 require_relative "surge_api/models/phone_number_list_params"
 require_relative "surge_api/models/phone_number_purchase_params"
 require_relative "surge_api/models/recording_completed_webhook_event"

data/rbi/surge_api/internal/util.rbi

@@ -301,6 +301,26 @@ module SurgeAPI
         T.let(%r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}, Regexp)
 
       class << self
+        # @api private
+        sig do
+          params(query: SurgeAPI::Internal::AnyHash).returns(
+            SurgeAPI::Internal::AnyHash
+          )
+        end
+        def encode_query_params(query)
+        end
+
+        # @api private
+        sig do
+          params(
+            collection: SurgeAPI::Internal::AnyHash,
+            key: String,
+            element: T.anything
+          ).void
+        end
+        private def write_query_param_element!(collection, key, element)
+        end
+
         # @api private
         sig do
           params(

data/rbi/surge_api/models/blast_create_params.rbi

@@ -50,7 +50,7 @@ module SurgeAPI
       sig { params(name: String).void }
       attr_writer :name
 
-      # Deprecated. Use `to` instead.
+      # Deprecated. Use `to` with audience IDs instead.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :segments
 
@@ -65,7 +65,7 @@ module SurgeAPI
       attr_writer :send_at
 
       # List of recipients to whom the blast should be sent. This can be a combination
-      # of contact IDs, segment IDs, and phone numbers.
+      # of contact IDs, audience IDs, and phone numbers.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :to
 
@@ -98,12 +98,12 @@ module SurgeAPI
         from: nil,
         # Optional name for the blast.
         name: nil,
-        # Deprecated. Use `to` instead.
+        # Deprecated. Use `to` with audience IDs instead.
         segments: nil,
         # When to send the blast. If not provided, sends immediately.
         send_at: nil,
         # List of recipients to whom the blast should be sent. This can be a combination
-        # of contact IDs, segment IDs, and phone numbers.
+        # of contact IDs, audience IDs, and phone numbers.
         to: nil,
         request_options: {}
       )

data/rbi/surge_api/models/campaign.rbi

@@ -276,7 +276,6 @@ module SurgeAPI
         DEACTIVATED =
           T.let(:deactivated, SurgeAPI::Campaign::Status::TaggedSymbol)
         IN_REVIEW = T.let(:in_review, SurgeAPI::Campaign::Status::TaggedSymbol)
-        PENDING = T.let(:pending, SurgeAPI::Campaign::Status::TaggedSymbol)
         REJECTED = T.let(:rejected, SurgeAPI::Campaign::Status::TaggedSymbol)
 
         sig do

data/rbi/surge_api/models/phone_number.rbi

@@ -12,6 +12,10 @@ module SurgeAPI
       sig { returns(String) }
       attr_accessor :id
 
+      # The unique identifier of the campaign this phone number is attached to, if any
+      sig { returns(T.nilable(String)) }
+      attr_accessor :campaign_id
+
       # The phone number in E.164 format
       sig { returns(String) }
       attr_accessor :number
@@ -24,6 +28,7 @@ module SurgeAPI
       sig do
         params(
           id: String,
+          campaign_id: T.nilable(String),
           number: String,
           type: SurgeAPI::PhoneNumber::Type::OrSymbol
         ).returns(T.attached_class)
@@ -31,6 +36,8 @@ module SurgeAPI
       def self.new(
         # Unique identifier for the phone number
         id:,
+        # The unique identifier of the campaign this phone number is attached to, if any
+        campaign_id:,
         # The phone number in E.164 format
         number:,
         # Whether the phone number is local, toll-free, or short code
@@ -42,6 +49,7 @@ module SurgeAPI
         override.returns(
           {
             id: String,
+            campaign_id: T.nilable(String),
             number: String,
             type: SurgeAPI::PhoneNumber::Type::TaggedSymbol
           }

data/rbi/surge_api/models/phone_number_attached_to_campaign_webhook_event.rbi

@@ -0,0 +1,181 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class PhoneNumberAttachedToCampaignWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent,
+            SurgeAPI::Internal::AnyHash
+          )
+        end
+
+      # The ID of the account in which this event occurred
+      sig { returns(String) }
+      attr_accessor :account_id
+
+      # The data associated with the event
+      sig { returns(SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data) }
+      attr_reader :data
+
+      sig do
+        params(
+          data:
+            SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::OrHash
+        ).void
+      end
+      attr_writer :data
+
+      # The timestamp when this event occurred, in ISO8601 format
+      sig { returns(Time) }
+      attr_accessor :timestamp
+
+      # The type of the event. Always `phone_number.attached_to_campaign` for this
+      # event.
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      sig do
+        params(
+          account_id: String,
+          data:
+            SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::OrHash,
+          timestamp: Time,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The ID of the account in which this event occurred
+        account_id:,
+        # The data associated with the event
+        data:,
+        # The timestamp when this event occurred, in ISO8601 format
+        timestamp:,
+        # The type of the event. Always `phone_number.attached_to_campaign` for this
+        # event.
+        type: :"phone_number.attached_to_campaign"
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            account_id: String,
+            data: SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data,
+            timestamp: Time,
+            type: Symbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data,
+              SurgeAPI::Internal::AnyHash
+            )
+          end
+
+        # The unique identifier for the phone number
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The unique identifier of the campaign this phone number is attached to
+        sig { returns(String) }
+        attr_accessor :campaign_id
+
+        # The phone number in E.164 format
+        sig { returns(String) }
+        attr_accessor :number
+
+        # Whether the phone number is local, toll-free, or short code
+        sig do
+          returns(
+            SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type::TaggedSymbol
+          )
+        end
+        attr_accessor :type
+
+        # The data associated with the event
+        sig do
+          params(
+            id: String,
+            campaign_id: String,
+            number: String,
+            type:
+              SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The unique identifier for the phone number
+          id:,
+          # The unique identifier of the campaign this phone number is attached to
+          campaign_id:,
+          # The phone number in E.164 format
+          number:,
+          # Whether the phone number is local, toll-free, or short code
+          type:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              campaign_id: String,
+              number: String,
+              type:
+                SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Whether the phone number is local, toll-free, or short code
+        module Type
+          extend SurgeAPI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          LOCAL =
+            T.let(
+              :local,
+              SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type::TaggedSymbol
+            )
+          SHORT_CODE =
+            T.let(
+              :short_code,
+              SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type::TaggedSymbol
+            )
+          TOLL_FREE =
+            T.let(
+              :toll_free,
+              SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/surge_api/models/unwrap_webhook_event.rbi

@@ -18,6 +18,7 @@ module SurgeAPI
             SurgeAPI::MessageFailedWebhookEvent,
             SurgeAPI::MessageReceivedWebhookEvent,
             SurgeAPI::MessageSentWebhookEvent,
+            SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent,
             SurgeAPI::RecordingCompletedWebhookEvent,
             SurgeAPI::VoicemailReceivedWebhookEvent
           )

data/rbi/surge_api/models.rbi

@@ -74,6 +74,9 @@ module SurgeAPI
 
   PhoneNumber = SurgeAPI::Models::PhoneNumber
 
+  PhoneNumberAttachedToCampaignWebhookEvent =
+    SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent
+
   PhoneNumberListParams = SurgeAPI::Models::PhoneNumberListParams
 
   PhoneNumberPurchaseParams = SurgeAPI::Models::PhoneNumberPurchaseParams

data/rbi/surge_api/resources/blasts.rbi

@@ -33,12 +33,12 @@ module SurgeAPI
         from: nil,
         # Optional name for the blast.
         name: nil,
-        # Deprecated. Use `to` instead.
+        # Deprecated. Use `to` with audience IDs instead.
         segments: nil,
         # When to send the blast. If not provided, sends immediately.
         send_at: nil,
         # List of recipients to whom the blast should be sent. This can be a combination
-        # of contact IDs, segment IDs, and phone numbers.
+        # of contact IDs, audience IDs, and phone numbers.
         to: nil,
         request_options: {}
       )

data/rbi/surge_api/resources/webhooks.rbi

@@ -16,6 +16,7 @@ module SurgeAPI
             SurgeAPI::MessageFailedWebhookEvent,
             SurgeAPI::MessageReceivedWebhookEvent,
             SurgeAPI::MessageSentWebhookEvent,
+            SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent,
             SurgeAPI::RecordingCompletedWebhookEvent,
             SurgeAPI::VoicemailReceivedWebhookEvent
           )

data/sig/surge_api/internal/util.rbs

@@ -106,6 +106,16 @@ module SurgeAPI
       JSON_CONTENT: Regexp
       JSONL_CONTENT: Regexp
 
+      def encode_query_params: (
+        ::Hash[Symbol, top] query
+      ) -> ::Hash[Symbol, top]
+
+      private def write_query_param_element!: (
+        ::Hash[Symbol, top] collection,
+        String key,
+        top element
+      ) -> nil
+
       def self?.write_multipart_content: (
         Enumerator::Yielder y,
         val: top,

data/sig/surge_api/models/campaign.rbs

@@ -84,13 +84,7 @@ module SurgeAPI
       end
 
       type status =
-        :active
-        | :canceled
-        | :created
-        | :deactivated
-        | :in_review
-        | :pending
-        | :rejected
+        :active | :canceled | :created | :deactivated | :in_review | :rejected
 
       module Status
         extend SurgeAPI::Internal::Type::Enum
@@ -100,7 +94,6 @@ module SurgeAPI
         CREATED: :created
         DEACTIVATED: :deactivated
         IN_REVIEW: :in_review
-        PENDING: :pending
         REJECTED: :rejected
 
         def self?.values: -> ::Array[SurgeAPI::Models::Campaign::status]

data/sig/surge_api/models/phone_number.rbs

@@ -1,23 +1,32 @@
 module SurgeAPI
   module Models
     type phone_number =
-      { id: String, number: String, type: SurgeAPI::Models::PhoneNumber::type_ }
+      {
+        id: String,
+        campaign_id: String?,
+        number: String,
+        type: SurgeAPI::Models::PhoneNumber::type_
+      }
 
     class PhoneNumber < SurgeAPI::Internal::Type::BaseModel
       attr_accessor id: String
 
+      attr_accessor campaign_id: String?
+
       attr_accessor number: String
 
       attr_accessor type: SurgeAPI::Models::PhoneNumber::type_
 
       def initialize: (
         id: String,
+        campaign_id: String?,
         number: String,
         type: SurgeAPI::Models::PhoneNumber::type_
       ) -> void
 
       def to_hash: -> {
         id: String,
+        campaign_id: String?,
         number: String,
         type: SurgeAPI::Models::PhoneNumber::type_
       }

data/sig/surge_api/models/phone_number_attached_to_campaign_webhook_event.rbs

@@ -0,0 +1,79 @@
+module SurgeAPI
+  module Models
+    type phone_number_attached_to_campaign_webhook_event =
+      {
+        account_id: String,
+        data: SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data,
+        timestamp: Time,
+        type: :"phone_number.attached_to_campaign"
+      }
+
+    class PhoneNumberAttachedToCampaignWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      attr_accessor account_id: String
+
+      attr_accessor data: SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data
+
+      attr_accessor timestamp: Time
+
+      attr_accessor type: :"phone_number.attached_to_campaign"
+
+      def initialize: (
+        account_id: String,
+        data: SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data,
+        timestamp: Time,
+        ?type: :"phone_number.attached_to_campaign"
+      ) -> void
+
+      def to_hash: -> {
+        account_id: String,
+        data: SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent::Data,
+        timestamp: Time,
+        type: :"phone_number.attached_to_campaign"
+      }
+
+      type data =
+        {
+          id: String,
+          campaign_id: String,
+          number: String,
+          type: SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data::type_
+        }
+
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        attr_accessor campaign_id: String
+
+        attr_accessor number: String
+
+        attr_accessor type: SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data::type_
+
+        def initialize: (
+          id: String,
+          campaign_id: String,
+          number: String,
+          type: SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data::type_
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          campaign_id: String,
+          number: String,
+          type: SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data::type_
+        }
+
+        type type_ = :local | :short_code | :toll_free
+
+        module Type
+          extend SurgeAPI::Internal::Type::Enum
+
+          LOCAL: :local
+          SHORT_CODE: :short_code
+          TOLL_FREE: :toll_free
+
+          def self?.values: -> ::Array[SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent::Data::type_]
+        end
+      end
+    end
+  end
+end

data/sig/surge_api/models/unwrap_webhook_event.rbs

@@ -11,6 +11,7 @@ module SurgeAPI
       | SurgeAPI::MessageFailedWebhookEvent
       | SurgeAPI::MessageReceivedWebhookEvent
       | SurgeAPI::MessageSentWebhookEvent
+      | SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent
       | SurgeAPI::RecordingCompletedWebhookEvent
       | SurgeAPI::VoicemailReceivedWebhookEvent
 

data/sig/surge_api/models.rbs

@@ -71,6 +71,8 @@ module SurgeAPI
 
   class PhoneNumber = SurgeAPI::Models::PhoneNumber
 
+  class PhoneNumberAttachedToCampaignWebhookEvent = SurgeAPI::Models::PhoneNumberAttachedToCampaignWebhookEvent
+
   class PhoneNumberListParams = SurgeAPI::Models::PhoneNumberListParams
 
   class PhoneNumberPurchaseParams = SurgeAPI::Models::PhoneNumberPurchaseParams

data/sig/surge_api/resources/webhooks.rbs

@@ -13,6 +13,7 @@ module SurgeAPI
       | SurgeAPI::MessageFailedWebhookEvent
       | SurgeAPI::MessageReceivedWebhookEvent
       | SurgeAPI::MessageSentWebhookEvent
+      | SurgeAPI::PhoneNumberAttachedToCampaignWebhookEvent
       | SurgeAPI::RecordingCompletedWebhookEvent
       | SurgeAPI::VoicemailReceivedWebhookEvent)
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: surge_api
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Surge
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-22 00:00:00.000000000 Z
+date: 2026-03-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -106,6 +106,7 @@ files:
 - lib/surge_api/models/message_sent_webhook_event.rb
 - lib/surge_api/models/organization.rb
 - lib/surge_api/models/phone_number.rb
+- lib/surge_api/models/phone_number_attached_to_campaign_webhook_event.rb
 - lib/surge_api/models/phone_number_list_params.rb
 - lib/surge_api/models/phone_number_purchase_params.rb
 - lib/surge_api/models/recording_completed_webhook_event.rb
@@ -196,6 +197,7 @@ files:
 - rbi/surge_api/models/message_sent_webhook_event.rbi
 - rbi/surge_api/models/organization.rbi
 - rbi/surge_api/models/phone_number.rbi
+- rbi/surge_api/models/phone_number_attached_to_campaign_webhook_event.rbi
 - rbi/surge_api/models/phone_number_list_params.rbi
 - rbi/surge_api/models/phone_number_purchase_params.rbi
 - rbi/surge_api/models/recording_completed_webhook_event.rbi
@@ -285,6 +287,7 @@ files:
 - sig/surge_api/models/message_sent_webhook_event.rbs
 - sig/surge_api/models/organization.rbs
 - sig/surge_api/models/phone_number.rbs
+- sig/surge_api/models/phone_number_attached_to_campaign_webhook_event.rbs
 - sig/surge_api/models/phone_number_list_params.rbs
 - sig/surge_api/models/phone_number_purchase_params.rbs
 - sig/surge_api/models/recording_completed_webhook_event.rbs