surge_api 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6419099e30ee4893563ecd9e9fd2e4707dedf5af633e5972d25b0848228deef9
-  data.tar.gz: 1c60adc5936f072f87f8b534f26a4cab6bf3a34ea5d48428675c8cfea4da6159
+  metadata.gz: 3e8128de1b743d0dfdea80a3444fe70781bb029f32061761b09b749cd8a1abf7
+  data.tar.gz: 543611ed65fb81164bd534cd91af8a0c6bc2bf96e5efda155aec5204a57c63ce
 SHA512:
-  metadata.gz: 3bcb5e868464704dad067a2a1e5b36a695689c3adf03e7b8e5978b2469dbe69bf2da75d7a4b0d6ad1613357a991e5a0f57e3110a95afc20eae0df4a7cc0ac751
-  data.tar.gz: 95e41f79bf6d869ac3201c21f15c1ceb7514d2d2e35c5172cba0e5db199bd1817300c9eea8d2050ad3493f08b2ecade4288c6c6b8907f53309cff1baf2001f65
+  metadata.gz: 4b124f0da4f0ee63a4e0d418a16059b1f049b26ca9c1361f712e1bd8890fc73d51d9a930818345e753bb22850442085000c293d4a39f9df891582e87b2b31ff3
+  data.tar.gz: b1a17edfc1c13106f82f11cd1732984f20e2ec7c5afa0ae055c5f31e795c77c9f307520ba38b411c9dda6687f11f91dcefa4cf61cd2b26a1c0a433b43ab54970

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.7.0 (2026-01-18)
+
+Full Changelog: [v0.6.0...v0.7.0](https://github.com/surgeapi/ruby-sdk/compare/v0.6.0...v0.7.0)
+
+### Features
+
+* **api:** api update ([3eaef18](https://github.com/surgeapi/ruby-sdk/commit/3eaef1827965563c4aba448425c32a7850d8d5ba))
+
+## 0.6.0 (2026-01-18)
+
+Full Changelog: [v0.5.0...v0.6.0](https://github.com/surgeapi/ruby-sdk/compare/v0.5.0...v0.6.0)
+
+### Features
+
+* **api:** api update ([be3de20](https://github.com/surgeapi/ruby-sdk/commit/be3de209f18482fa76b1a447fd8e944efb56772f))
+
+
+### Chores
+
+* **internal:** update `actions/checkout` version ([3d4be8e](https://github.com/surgeapi/ruby-sdk/commit/3d4be8e99c4f71d93e66a2d830d23e1008490abc))
+
 ## 0.5.0 (2026-01-15)
 
 Full Changelog: [v0.4.0...v0.5.0](https://github.com/surgeapi/ruby-sdk/compare/v0.4.0...v0.5.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.5.0"
+gem "surge_api", "~> 0.7.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/surge_api/models/link_followed_webhook_event.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module SurgeAPI
+  module Models
+    class LinkFollowedWebhookEvent < 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::LinkFollowedWebhookEvent::Data]
+      required :data, -> { SurgeAPI::LinkFollowedWebhookEvent::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 `link.followed` for this event.
+      #
+      #   @return [Symbol, :"link.followed"]
+      required :type, const: :"link.followed"
+
+      # @!method initialize(account_id:, data:, timestamp:, type: :"link.followed")
+      #   @param account_id [String] The ID of the account in which this event occurred
+      #
+      #   @param data [SurgeAPI::Models::LinkFollowedWebhookEvent::Data] The data associated with the event
+      #
+      #   @param timestamp [Time] The timestamp when this event occurred, in ISO8601 format
+      #
+      #   @param type [Symbol, :"link.followed"] The type of the event. Always `link.followed` for this event.
+
+      # @see SurgeAPI::Models::LinkFollowedWebhookEvent#data
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique identifier for the link
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute message_id
+        #   The unique identifier for the message that contained the link
+        #
+        #   @return [String]
+        required :message_id, String
+
+        # @!attribute url
+        #   The original URL that was shortened
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!method initialize(id:, message_id:, url:)
+        #   The data associated with the event
+        #
+        #   @param id [String] The unique identifier for the link
+        #
+        #   @param message_id [String] The unique identifier for the message that contained the link
+        #
+        #   @param url [String] The original URL that was shortened
+      end
+    end
+  end
+end

data/lib/surge_api/models/message.rb

@@ -27,7 +27,13 @@ module SurgeAPI
       #   @return [SurgeAPI::Models::Message::Conversation, nil]
       optional :conversation, -> { SurgeAPI::Message::Conversation }
 
-      # @!method initialize(id: nil, attachments: nil, body: nil, conversation: nil)
+      # @!attribute metadata
+      #   Set of key-value pairs that will be stored with the object.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :metadata, SurgeAPI::Internal::Type::HashOf[String]
+
+      # @!method initialize(id: nil, attachments: nil, body: nil, conversation: nil, metadata: nil)
       #   A Message is a communication sent to a Contact.
       #
       #   @param id [String] Unique identifier for the object.
@@ -37,6 +43,8 @@ module SurgeAPI
       #   @param body [String] The message body.
       #
       #   @param conversation [SurgeAPI::Models::Message::Conversation] A conversation with a Contact
+      #
+      #   @param metadata [Hash{Symbol=>String}] Set of key-value pairs that will be stored with the object.
 
       class Attachment < SurgeAPI::Internal::Type::BaseModel
         # @!attribute id

data/lib/surge_api/models/message_params.rb

@@ -34,6 +34,12 @@ module SurgeAPI
         #   @return [String, nil]
         optional :body, String
 
+        # @!attribute metadata
+        #   Set of key-value pairs that will be stored with the object.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :metadata, SurgeAPI::Internal::Type::HashOf[String]
+
         # @!attribute send_at
         #   An optional datetime for scheduling message up to a couple of months in the
         #   future.
@@ -41,7 +47,7 @@ module SurgeAPI
         #   @return [Time, nil]
         optional :send_at, Time
 
-        # @!method initialize(conversation:, attachments: nil, body: nil, send_at: nil)
+        # @!method initialize(conversation:, attachments: nil, body: nil, metadata: nil, send_at: nil)
         #   Some parameter documentations has been truncated, see
         #   {SurgeAPI::Models::MessageParams::MessageParamsWithConversation} for more
         #   details.
@@ -55,6 +61,8 @@ module SurgeAPI
         #
         #   @param body [String] The message body.
         #
+        #   @param metadata [Hash{Symbol=>String}] Set of key-value pairs that will be stored with the object.
+        #
         #   @param send_at [Time] An optional datetime for scheduling message up to a couple of months in the futu
 
         # @see SurgeAPI::Models::MessageParams::MessageParamsWithConversation#conversation
@@ -172,6 +180,12 @@ module SurgeAPI
         #   @return [String, nil]
         optional :from, String
 
+        # @!attribute metadata
+        #   Set of key-value pairs that will be stored with the object.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :metadata, SurgeAPI::Internal::Type::HashOf[String]
+
         # @!attribute send_at
         #   An optional datetime for scheduling message up to a couple of months in the
         #   future.
@@ -179,7 +193,7 @@ module SurgeAPI
         #   @return [Time, nil]
         optional :send_at, Time
 
-        # @!method initialize(to:, attachments: nil, body: nil, from: nil, send_at: nil)
+        # @!method initialize(to:, attachments: nil, body: nil, from: nil, metadata: nil, send_at: nil)
         #   Some parameter documentations has been truncated, see
         #   {SurgeAPI::Models::MessageParams::SimpleMessageParams} for more details.
         #
@@ -193,6 +207,8 @@ module SurgeAPI
         #
         #   @param from [String] The sender's phone number in E.164 format or phone number ID. If omitted, uses t
         #
+        #   @param metadata [Hash{Symbol=>String}] Set of key-value pairs that will be stored with the object.
+        #
         #   @param send_at [Time] An optional datetime for scheduling message up to a couple of months in the futu
 
         class Attachment < SurgeAPI::Internal::Type::BaseModel

data/lib/surge_api/models/unwrap_webhook_event.rb

@@ -17,6 +17,8 @@ module SurgeAPI
 
       variant :"conversation.created", -> { SurgeAPI::ConversationCreatedWebhookEvent }
 
+      variant :"link.followed", -> { SurgeAPI::LinkFollowedWebhookEvent }
+
       variant :"message.delivered", -> { SurgeAPI::MessageDeliveredWebhookEvent }
 
       variant :"message.failed", -> { SurgeAPI::MessageFailedWebhookEvent }
@@ -26,7 +28,7 @@ module SurgeAPI
       variant :"message.sent", -> { SurgeAPI::MessageSentWebhookEvent }
 
       # @!method self.variants
-      #   @return [Array(SurgeAPI::Models::CallEndedWebhookEvent, SurgeAPI::Models::CampaignApprovedWebhookEvent, SurgeAPI::Models::ContactOptedInWebhookEvent, SurgeAPI::Models::ContactOptedOutWebhookEvent, SurgeAPI::Models::ConversationCreatedWebhookEvent, SurgeAPI::Models::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent)]
+      #   @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)]
     end
   end
 end

data/lib/surge_api/models.rb

@@ -81,6 +81,8 @@ module SurgeAPI
 
   Error = SurgeAPI::Models::Error
 
+  LinkFollowedWebhookEvent = SurgeAPI::Models::LinkFollowedWebhookEvent
+
   Message = SurgeAPI::Models::Message
 
   MessageCreateParams = SurgeAPI::Models::MessageCreateParams

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::MessageDeliveredWebhookEvent, SurgeAPI::Models::MessageFailedWebhookEvent, SurgeAPI::Models::MessageReceivedWebhookEvent, SurgeAPI::Models::MessageSentWebhookEvent]
+      # @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]
       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.5.0"
+  VERSION = "0.7.0"
 end

data/lib/surge_api.rb

@@ -74,6 +74,7 @@ require_relative "surge_api/models/contact_retrieve_params"
 require_relative "surge_api/models/contact_update_params"
 require_relative "surge_api/models/conversation_created_webhook_event"
 require_relative "surge_api/models/error"
+require_relative "surge_api/models/link_followed_webhook_event"
 require_relative "surge_api/models/message"
 require_relative "surge_api/models/message_create_params"
 require_relative "surge_api/models/message_delivered_webhook_event"

data/rbi/surge_api/models/link_followed_webhook_event.rbi

@@ -0,0 +1,110 @@
+# typed: strong
+
+module SurgeAPI
+  module Models
+    class LinkFollowedWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(SurgeAPI::LinkFollowedWebhookEvent, 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::LinkFollowedWebhookEvent::Data) }
+      attr_reader :data
+
+      sig do
+        params(data: SurgeAPI::LinkFollowedWebhookEvent::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 `link.followed` for this event.
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      sig do
+        params(
+          account_id: String,
+          data: SurgeAPI::LinkFollowedWebhookEvent::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 `link.followed` for this event.
+        type: :"link.followed"
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            account_id: String,
+            data: SurgeAPI::LinkFollowedWebhookEvent::Data,
+            timestamp: Time,
+            type: Symbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              SurgeAPI::LinkFollowedWebhookEvent::Data,
+              SurgeAPI::Internal::AnyHash
+            )
+          end
+
+        # The unique identifier for the link
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The unique identifier for the message that contained the link
+        sig { returns(String) }
+        attr_accessor :message_id
+
+        # The original URL that was shortened
+        sig { returns(String) }
+        attr_accessor :url
+
+        # The data associated with the event
+        sig do
+          params(id: String, message_id: String, url: String).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The unique identifier for the link
+          id:,
+          # The unique identifier for the message that contained the link
+          message_id:,
+          # The original URL that was shortened
+          url:
+        )
+        end
+
+        sig do
+          override.returns({ id: String, message_id: String, url: String })
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/surge_api/models/message.rbi

@@ -37,13 +37,21 @@ module SurgeAPI
       sig { params(conversation: SurgeAPI::Message::Conversation::OrHash).void }
       attr_writer :conversation
 
+      # Set of key-value pairs that will be stored with the object.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :metadata
+
+      sig { params(metadata: T::Hash[Symbol, String]).void }
+      attr_writer :metadata
+
       # A Message is a communication sent to a Contact.
       sig do
         params(
           id: String,
           attachments: T::Array[SurgeAPI::Message::Attachment::OrHash],
           body: String,
-          conversation: SurgeAPI::Message::Conversation::OrHash
+          conversation: SurgeAPI::Message::Conversation::OrHash,
+          metadata: T::Hash[Symbol, String]
         ).returns(T.attached_class)
       end
       def self.new(
@@ -53,7 +61,9 @@ module SurgeAPI
         # The message body.
         body: nil,
         # A conversation with a Contact
-        conversation: nil
+        conversation: nil,
+        # Set of key-value pairs that will be stored with the object.
+        metadata: nil
       )
       end
 
@@ -63,7 +73,8 @@ module SurgeAPI
             id: String,
             attachments: T::Array[SurgeAPI::Message::Attachment],
             body: String,
-            conversation: SurgeAPI::Message::Conversation
+            conversation: SurgeAPI::Message::Conversation,
+            metadata: T::Hash[Symbol, String]
           }
         )
       end

data/rbi/surge_api/models/message_params.rbi

@@ -70,6 +70,13 @@ module SurgeAPI
         sig { params(body: String).void }
         attr_writer :body
 
+        # Set of key-value pairs that will be stored with the object.
+        sig { returns(T.nilable(T::Hash[Symbol, String])) }
+        attr_reader :metadata
+
+        sig { params(metadata: T::Hash[Symbol, String]).void }
+        attr_writer :metadata
+
         # An optional datetime for scheduling message up to a couple of months in the
         # future.
         sig { returns(T.nilable(Time)) }
@@ -89,6 +96,7 @@ module SurgeAPI
                 SurgeAPI::MessageParams::MessageParamsWithConversation::Attachment::OrHash
               ],
             body: String,
+            metadata: T::Hash[Symbol, String],
             send_at: Time
           ).returns(T.attached_class)
         end
@@ -99,6 +107,8 @@ module SurgeAPI
           attachments: nil,
           # The message body.
           body: nil,
+          # Set of key-value pairs that will be stored with the object.
+          metadata: nil,
           # An optional datetime for scheduling message up to a couple of months in the
           # future.
           send_at: nil
@@ -115,6 +125,7 @@ module SurgeAPI
                   SurgeAPI::MessageParams::MessageParamsWithConversation::Attachment
                 ],
               body: String,
+              metadata: T::Hash[Symbol, String],
               send_at: Time
             }
           )
@@ -341,6 +352,13 @@ module SurgeAPI
         sig { params(from: String).void }
         attr_writer :from
 
+        # Set of key-value pairs that will be stored with the object.
+        sig { returns(T.nilable(T::Hash[Symbol, String])) }
+        attr_reader :metadata
+
+        sig { params(metadata: T::Hash[Symbol, String]).void }
+        attr_writer :metadata
+
         # An optional datetime for scheduling message up to a couple of months in the
         # future.
         sig { returns(T.nilable(Time)) }
@@ -359,6 +377,7 @@ module SurgeAPI
               ],
             body: String,
             from: String,
+            metadata: T::Hash[Symbol, String],
             send_at: Time
           ).returns(T.attached_class)
         end
@@ -372,6 +391,8 @@ module SurgeAPI
           # The sender's phone number in E.164 format or phone number ID. If omitted, uses
           # the account's default phone number. Cannot be used together with 'conversation'.
           from: nil,
+          # Set of key-value pairs that will be stored with the object.
+          metadata: nil,
           # An optional datetime for scheduling message up to a couple of months in the
           # future.
           send_at: nil
@@ -388,6 +409,7 @@ module SurgeAPI
                 ],
               body: String,
               from: String,
+              metadata: T::Hash[Symbol, String],
               send_at: Time
             }
           )

data/rbi/surge_api/models/unwrap_webhook_event.rbi

@@ -13,6 +13,7 @@ module SurgeAPI
             SurgeAPI::ContactOptedInWebhookEvent,
             SurgeAPI::ContactOptedOutWebhookEvent,
             SurgeAPI::ConversationCreatedWebhookEvent,
+            SurgeAPI::LinkFollowedWebhookEvent,
             SurgeAPI::MessageDeliveredWebhookEvent,
             SurgeAPI::MessageFailedWebhookEvent,
             SurgeAPI::MessageReceivedWebhookEvent,

data/rbi/surge_api/models.rbi

@@ -44,6 +44,8 @@ module SurgeAPI
 
   Error = SurgeAPI::Models::Error
 
+  LinkFollowedWebhookEvent = SurgeAPI::Models::LinkFollowedWebhookEvent
+
   Message = SurgeAPI::Models::Message
 
   MessageCreateParams = SurgeAPI::Models::MessageCreateParams

data/rbi/surge_api/resources/webhooks.rbi

@@ -11,6 +11,7 @@ module SurgeAPI
             SurgeAPI::ContactOptedInWebhookEvent,
             SurgeAPI::ContactOptedOutWebhookEvent,
             SurgeAPI::ConversationCreatedWebhookEvent,
+            SurgeAPI::LinkFollowedWebhookEvent,
             SurgeAPI::MessageDeliveredWebhookEvent,
             SurgeAPI::MessageFailedWebhookEvent,
             SurgeAPI::MessageReceivedWebhookEvent,

data/sig/surge_api/models/link_followed_webhook_event.rbs

@@ -0,0 +1,49 @@
+module SurgeAPI
+  module Models
+    type link_followed_webhook_event =
+      {
+        account_id: String,
+        data: SurgeAPI::LinkFollowedWebhookEvent::Data,
+        timestamp: Time,
+        type: :"link.followed"
+      }
+
+    class LinkFollowedWebhookEvent < SurgeAPI::Internal::Type::BaseModel
+      attr_accessor account_id: String
+
+      attr_accessor data: SurgeAPI::LinkFollowedWebhookEvent::Data
+
+      attr_accessor timestamp: Time
+
+      attr_accessor type: :"link.followed"
+
+      def initialize: (
+        account_id: String,
+        data: SurgeAPI::LinkFollowedWebhookEvent::Data,
+        timestamp: Time,
+        ?type: :"link.followed"
+      ) -> void
+
+      def to_hash: -> {
+        account_id: String,
+        data: SurgeAPI::LinkFollowedWebhookEvent::Data,
+        timestamp: Time,
+        type: :"link.followed"
+      }
+
+      type data = { id: String, message_id: String, url: String }
+
+      class Data < SurgeAPI::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        attr_accessor message_id: String
+
+        attr_accessor url: String
+
+        def initialize: (id: String, message_id: String, url: String) -> void
+
+        def to_hash: -> { id: String, message_id: String, url: String }
+      end
+    end
+  end
+end

data/sig/surge_api/models/message.rbs

@@ -5,7 +5,8 @@ module SurgeAPI
         id: String,
         attachments: ::Array[SurgeAPI::Message::Attachment],
         body: String,
-        conversation: SurgeAPI::Message::Conversation
+        conversation: SurgeAPI::Message::Conversation,
+        metadata: ::Hash[Symbol, String]
       }
 
     class Message < SurgeAPI::Internal::Type::BaseModel
@@ -29,18 +30,24 @@ module SurgeAPI
         SurgeAPI::Message::Conversation
       ) -> SurgeAPI::Message::Conversation
 
+      attr_reader metadata: ::Hash[Symbol, String]?
+
+      def metadata=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
       def initialize: (
         ?id: String,
         ?attachments: ::Array[SurgeAPI::Message::Attachment],
         ?body: String,
-        ?conversation: SurgeAPI::Message::Conversation
+        ?conversation: SurgeAPI::Message::Conversation,
+        ?metadata: ::Hash[Symbol, String]
       ) -> void
 
       def to_hash: -> {
         id: String,
         attachments: ::Array[SurgeAPI::Message::Attachment],
         body: String,
-        conversation: SurgeAPI::Message::Conversation
+        conversation: SurgeAPI::Message::Conversation,
+        metadata: ::Hash[Symbol, String]
       }
 
       type attachment = { id: String, type: String, url: String }

data/sig/surge_api/models/message_params.rbs

@@ -12,6 +12,7 @@ module SurgeAPI
           conversation: SurgeAPI::MessageParams::MessageParamsWithConversation::Conversation,
           attachments: ::Array[SurgeAPI::MessageParams::MessageParamsWithConversation::Attachment],
           body: String,
+          metadata: ::Hash[Symbol, String],
           send_at: Time
         }
 
@@ -28,6 +29,10 @@ module SurgeAPI
 
         def body=: (String) -> String
 
+        attr_reader metadata: ::Hash[Symbol, String]?
+
+        def metadata=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
         attr_reader send_at: Time?
 
         def send_at=: (Time) -> Time
@@ -36,6 +41,7 @@ module SurgeAPI
           conversation: SurgeAPI::MessageParams::MessageParamsWithConversation::Conversation,
           ?attachments: ::Array[SurgeAPI::MessageParams::MessageParamsWithConversation::Attachment],
           ?body: String,
+          ?metadata: ::Hash[Symbol, String],
           ?send_at: Time
         ) -> void
 
@@ -43,6 +49,7 @@ module SurgeAPI
           conversation: SurgeAPI::MessageParams::MessageParamsWithConversation::Conversation,
           attachments: ::Array[SurgeAPI::MessageParams::MessageParamsWithConversation::Attachment],
           body: String,
+          metadata: ::Hash[Symbol, String],
           send_at: Time
         }
 
@@ -132,6 +139,7 @@ module SurgeAPI
           attachments: ::Array[SurgeAPI::MessageParams::SimpleMessageParams::Attachment],
           body: String,
           from: String,
+          metadata: ::Hash[Symbol, String],
           send_at: Time
         }
 
@@ -152,6 +160,10 @@ module SurgeAPI
 
         def from=: (String) -> String
 
+        attr_reader metadata: ::Hash[Symbol, String]?
+
+        def metadata=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
+
         attr_reader send_at: Time?
 
         def send_at=: (Time) -> Time
@@ -161,6 +173,7 @@ module SurgeAPI
           ?attachments: ::Array[SurgeAPI::MessageParams::SimpleMessageParams::Attachment],
           ?body: String,
           ?from: String,
+          ?metadata: ::Hash[Symbol, String],
           ?send_at: Time
         ) -> void
 
@@ -169,6 +182,7 @@ module SurgeAPI
           attachments: ::Array[SurgeAPI::MessageParams::SimpleMessageParams::Attachment],
           body: String,
           from: String,
+          metadata: ::Hash[Symbol, String],
           send_at: Time
         }
 

data/sig/surge_api/models/unwrap_webhook_event.rbs

@@ -6,6 +6,7 @@ module SurgeAPI
       | SurgeAPI::ContactOptedInWebhookEvent
       | SurgeAPI::ContactOptedOutWebhookEvent
       | SurgeAPI::ConversationCreatedWebhookEvent
+      | SurgeAPI::LinkFollowedWebhookEvent
       | SurgeAPI::MessageDeliveredWebhookEvent
       | SurgeAPI::MessageFailedWebhookEvent
       | SurgeAPI::MessageReceivedWebhookEvent

data/sig/surge_api/models.rbs

@@ -41,6 +41,8 @@ module SurgeAPI
 
   class Error = SurgeAPI::Models::Error
 
+  class LinkFollowedWebhookEvent = SurgeAPI::Models::LinkFollowedWebhookEvent
+
   class Message = SurgeAPI::Models::Message
 
   class MessageCreateParams = SurgeAPI::Models::MessageCreateParams

data/sig/surge_api/resources/webhooks.rbs

@@ -8,6 +8,7 @@ module SurgeAPI
       | SurgeAPI::ContactOptedInWebhookEvent
       | SurgeAPI::ContactOptedOutWebhookEvent
       | SurgeAPI::ConversationCreatedWebhookEvent
+      | SurgeAPI::LinkFollowedWebhookEvent
       | SurgeAPI::MessageDeliveredWebhookEvent
       | SurgeAPI::MessageFailedWebhookEvent
       | SurgeAPI::MessageReceivedWebhookEvent

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: surge_api
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Surge
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-15 00:00:00.000000000 Z
+date: 2026-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -90,6 +90,7 @@ files:
 - lib/surge_api/models/contact_update_params.rb
 - lib/surge_api/models/conversation_created_webhook_event.rb
 - lib/surge_api/models/error.rb
+- lib/surge_api/models/link_followed_webhook_event.rb
 - lib/surge_api/models/message.rb
 - lib/surge_api/models/message_create_params.rb
 - lib/surge_api/models/message_delivered_webhook_event.rb
@@ -166,6 +167,7 @@ files:
 - rbi/surge_api/models/contact_update_params.rbi
 - rbi/surge_api/models/conversation_created_webhook_event.rbi
 - rbi/surge_api/models/error.rbi
+- rbi/surge_api/models/link_followed_webhook_event.rbi
 - rbi/surge_api/models/message.rbi
 - rbi/surge_api/models/message_create_params.rbi
 - rbi/surge_api/models/message_delivered_webhook_event.rbi
@@ -241,6 +243,7 @@ files:
 - sig/surge_api/models/contact_update_params.rbs
 - sig/surge_api/models/conversation_created_webhook_event.rbs
 - sig/surge_api/models/error.rbs
+- sig/surge_api/models/link_followed_webhook_event.rbs
 - sig/surge_api/models/message.rbs
 - sig/surge_api/models/message_create_params.rbs
 - sig/surge_api/models/message_delivered_webhook_event.rbs