rcs 2.0.15 → 2.0.16.pre.rc.2

data/lib/pinnacle/types/form_theme_override.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Sparse override layered on top of your team's theme. Every field is optional; provided fields replace the
+    # corresponding team defaults at render time. URL fields must use `https://`.
+    class FormThemeOverride < Internal::Types::Model
+      field :logo_url, -> { String }, optional: true, nullable: false
+      field :favicon_url, -> { String }, optional: true, nullable: false
+      field :theme_mode, -> { Pinnacle::Types::FormThemeOverrideThemeMode }, optional: true, nullable: false
+      field :colors, -> { Pinnacle::Types::FormThemeOverrideColors }, optional: true, nullable: false
+      field :font_family, -> { Pinnacle::Types::FormThemeOverrideFontFamily }, optional: true, nullable: false
+      field :corner_radius, -> { Pinnacle::Types::FormThemeOverrideCornerRadius }, optional: true, nullable: false
+      field :content_alignment, -> { Pinnacle::Types::FormThemeOverrideContentAlignment }, optional: true, nullable: false
+      field :background, -> { Pinnacle::Types::FormBackground }, optional: true, nullable: false
+      field :submit_button_label, -> { String }, optional: true, nullable: false
+      field :success_message, -> { String }, optional: true, nullable: false
+      field :redirect_url, -> { String }, optional: true, nullable: false
+      field :privacy_url, -> { String }, optional: true, nullable: false
+      field :terms_url, -> { String }, optional: true, nullable: false
+      field :og_image_url, -> { String }, optional: true, nullable: false
+      field :og_description, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/form_theme_override_colors.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Per-mode palette overrides. Each mode is an object with optional `primary`, `background`, and `text` hex colors.
+    # Omit a mode to inherit the team default for it.
+    class FormThemeOverrideColors < Internal::Types::Model
+      field :light, -> { Pinnacle::Types::FormColorPalette }, optional: true, nullable: false
+      field :dark, -> { Pinnacle::Types::FormColorPalette }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/form_theme_override_content_alignment.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    module FormThemeOverrideContentAlignment
+      extend Pinnacle::Internal::Types::Enum
+
+      LEFT = "left"
+      CENTER = "center"
+      RIGHT = "right"
+    end
+  end
+end

data/lib/pinnacle/types/form_theme_override_corner_radius.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    module FormThemeOverrideCornerRadius
+      extend Pinnacle::Internal::Types::Enum
+
+      SHARP = "sharp"
+      ROUNDED = "rounded"
+      PILL = "pill"
+    end
+  end
+end

data/lib/pinnacle/types/form_theme_override_font_family.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    module FormThemeOverrideFontFamily
+      extend Pinnacle::Internal::Types::Enum
+
+      INTER = "inter"
+      SYSTEM = "system"
+      SERIF = "serif"
+      MONO = "mono"
+      ROUNDED = "rounded"
+    end
+  end
+end

data/lib/pinnacle/types/form_theme_override_theme_mode.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    module FormThemeOverrideThemeMode
+      extend Pinnacle::Internal::Types::Enum
+
+      LIGHT = "light"
+      DARK = "dark"
+      AUTO = "auto"
+    end
+  end
+end

data/lib/pinnacle/types/list_form_submissions_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Paginated page of submissions for a form.
+    class ListFormSubmissionsResponse < Internal::Types::Model
+      field :data, -> { Internal::Types::Array[Pinnacle::Types::FormSubmission] }, optional: false, nullable: false
+      field :has_more, -> { Internal::Types::Boolean }, optional: false, nullable: false, api_name: "hasMore"
+      field :count, -> { Integer }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/list_forms_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Paginated page of forms.
+    class ListFormsResponse < Internal::Types::Model
+      field :data, -> { Internal::Types::Array[Pinnacle::Types::Form] }, optional: false, nullable: false
+      field :has_more, -> { Internal::Types::Boolean }, optional: false, nullable: false, api_name: "hasMore"
+      field :count, -> { Integer }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/number_field.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Numeric input with optional `min` / `max` bounds and `step` granularity.
+    class NumberField < Internal::Types::Model
+      field :placeholder, -> { String }, optional: true, nullable: false
+      field :min, -> { Integer }, optional: true, nullable: false
+      field :max, -> { Integer }, optional: true, nullable: false
+      field :step, -> { Integer }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/phone_field.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Phone input. Client formats the value as the user types ("(555) 555-1212") and normalizes to E.164
+    # ("+15555551212") before submission.
+    class PhoneField < Internal::Types::Model
+      field :placeholder, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/radio_field.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Single-select radio group.
+    class RadioField < Internal::Types::Model
+      field :options, -> { Internal::Types::Array[Pinnacle::Types::FormFieldOption] }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/range_field.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Slider input. `min`/`max` define the bounds, `step` the granularity.
+    class RangeField < Internal::Types::Model
+      field :min, -> { Integer }, optional: true, nullable: false
+      field :max, -> { Integer }, optional: true, nullable: false
+      field :step, -> { Integer }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/rating_field.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Star rating 1..`max`. Submitted value is the selected integer.
+    class RatingField < Internal::Types::Model
+      field :min, -> { Integer }, optional: true, nullable: false
+      field :max, -> { Integer }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/rcs_cards_content.rb

@@ -7,7 +7,7 @@ module Pinnacle
     # See (supported file types)[https://app.pinnacle.sh/supported-file-types?type=RCS-CARD].
     class RcsCardsContent < Internal::Types::Model
       field :cards, -> { Internal::Types::Array[Pinnacle::Types::RcsCardsContentCardsItem] }, optional: false, nullable: false
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
     end
   end
 end

data/lib/pinnacle/types/rcs_cards_content_cards_item.rb

@@ -4,7 +4,7 @@ module Pinnacle
   module Types
     # Individual card containing title, optional media, and action buttons.
     class RcsCardsContentCardsItem < Internal::Types::Model
-      field :buttons, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false
+      field :buttons, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false
       field :media, -> { Pinnacle::Types::RcsMediaDetailsContent }, optional: true, nullable: false
       field :subtitle, -> { String }, optional: true, nullable: false
       field :title, -> { String }, optional: false, nullable: false

data/lib/pinnacle/types/rcs_media_content.rb

@@ -7,7 +7,7 @@ module Pinnacle
     # See (supported file types)[https://app.pinnacle.sh/supported-file-types?type=RCS-MEDIA].
     class RcsMediaContent < Internal::Types::Model
       field :media, -> { Pinnacle::Types::RcsMediaDetailsContent }, optional: false, nullable: false
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
     end
   end
 end

data/lib/pinnacle/types/rcs_validate_content_media.rb

@@ -7,7 +7,7 @@ module Pinnacle
     # See [supported media types](https://app.pinnacle.sh/supported-file-types?type=RCS-MEDIA).
     class RcsValidateContentMedia < Internal::Types::Model
       field :media, -> { String }, optional: false, nullable: false
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
     end
   end
 end

data/lib/pinnacle/types/rich_card.rb

@@ -4,7 +4,7 @@ module Pinnacle
   module Types
     # Individual card containing title, optional media, and action buttons.
     class RichCard < Internal::Types::Model
-      field :buttons, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false
+      field :buttons, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false
       field :media, -> { String }, optional: true, nullable: false
       field :subtitle, -> { String }, optional: true, nullable: false
       field :title, -> { String }, optional: false, nullable: false

data/lib/pinnacle/types/rich_cards.rb

@@ -7,7 +7,7 @@ module Pinnacle
     # See (supported file types)[https://app.pinnacle.sh/supported-file-types?type=RCS-CARD].
     class RichCards < Internal::Types::Model
       field :cards, -> { Internal::Types::Array[Pinnacle::Types::RichCard] }, optional: false, nullable: false
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
     end
   end
 end

data/lib/pinnacle/types/rich_media_message.rb

@@ -4,7 +4,7 @@ module Pinnacle
   module Types
     class RichMediaMessage < Internal::Types::Model
       field :media, -> { String }, optional: false, nullable: false
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
     end
   end
 end

data/lib/pinnacle/types/rich_text.rb

@@ -4,7 +4,7 @@ module Pinnacle
   module Types
     # Message containing longer text content with optional quick reply buttons.
     class RichText < Internal::Types::Model
-      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: false, nullable: false, api_name: "quickReplies"
+      field :quick_replies, -> { Internal::Types::Array[Pinnacle::Types::RichButton] }, optional: true, nullable: false, api_name: "quickReplies"
       field :text, -> { String }, optional: false, nullable: false
     end
   end

data/lib/pinnacle/types/scheduled_form_send_response_form.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    class ScheduledFormSendResponseForm < Internal::Types::Model
+      field :id, -> { String }, optional: false, nullable: false
+      field :name, -> { String }, optional: false, nullable: true
+    end
+  end
+end

data/lib/pinnacle/types/scheduled_form_send_response_submission.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    class ScheduledFormSendResponseSubmission < Internal::Types::Model
+      field :id, -> { String }, optional: false, nullable: false
+      field :url, -> { String }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/scheduled_form_send_result.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Response shape for a scheduled form send — returned in place of `SendFormResponse` when `options.schedule` is set.
+    class ScheduledFormSendResult < Internal::Types::Model
+      field :schedule_id, -> { String }, optional: false, nullable: false, api_name: "scheduleId"
+      field :config, -> { Pinnacle::Types::MessageSchedule }, optional: false, nullable: false
+      field :form, -> { Pinnacle::Types::ScheduledFormSendResponseForm }, optional: false, nullable: false
+      field :submission, -> { Pinnacle::Types::ScheduledFormSendResponseSubmission }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/select_field.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Single-select dropdown.
+    class SelectField < Internal::Types::Model
+      field :options, -> { Internal::Types::Array[Pinnacle::Types::FormFieldOption] }, optional: false, nullable: false
+      field :placeholder, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/send_form_options.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Optional delivery knobs shared by RCS and SMS sends.
+    class SendFormOptions < Internal::Types::Model
+      field :schedule, -> { Pinnacle::Types::MessageSchedule }, optional: true, nullable: false
+      field :webview_mode, -> { Pinnacle::Types::SendFormOptionsWebviewMode }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/send_form_options_webview_mode.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    module SendFormOptionsWebviewMode
+      extend Pinnacle::Internal::Types::Enum
+
+      FULL = "FULL"
+      HALF = "HALF"
+      TALL = "TALL"
+    end
+  end
+end

data/lib/pinnacle/types/send_form_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Send a form to a recipient over SMS or RCS in one call, or mint a standalone submission URL when `to` is omitted.
+    # Picks the SMS or RCS branch based on the shape of `from` (agent_* → RCS, E.164 → SMS).
+    #
+    # When `to` is provided, Pinnacle dispatches the message immediately and the recipient is recorded on the response
+    # (`submission.to` is set to the same E.164 number, and `message_id` is the id of the outbound SMS/RCS).
+    #
+    # When `to` is omitted, no message is sent — `submission.to` and `message_id` are both `null` and only the
+    # submission URL is returned.
+    class SendFormParams < Internal::Types::Model
+      extend Pinnacle::Internal::Types::Union
+
+      member -> { Pinnacle::Types::SendFormViaRcsParams }
+      member -> { Pinnacle::Types::SendFormViaSmsParams }
+    end
+  end
+end

data/lib/pinnacle/types/send_form_result.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Successful `POST /forms/send` response.
+    #
+    # - When `to` was provided in the request, the message was dispatched: `submission.to` echoes that recipient and
+    # `message_id` is the id of the outbound SMS/RCS that carried the URL.
+    # - When `to` was omitted, no message was sent: both `submission.to` and `message_id` are `null` and only the
+    # submission URL is returned.
+    class SendFormResult < Internal::Types::Model
+      field :form, -> { Pinnacle::Types::Form }, optional: false, nullable: false
+      field :submission, -> { Pinnacle::Types::FormSubmission }, optional: false, nullable: false
+      field :message_id, -> { String }, optional: false, nullable: true
+    end
+  end
+end

data/lib/pinnacle/types/send_form_via_rcs_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Send a form from an RCS agent. `from` must be an `agent_*` id.
+    class SendFormViaRcsParams < Internal::Types::Model
+      field :from, -> { String }, optional: false, nullable: false
+      field :to, -> { String }, optional: true, nullable: false
+      field :form, -> { Pinnacle::Types::SendFormViaRcsRequestForm }, optional: false, nullable: false
+      field :fallback, -> { Pinnacle::Types::SendFormViaRcsRequestFallback }, optional: true, nullable: false
+      field :options, -> { Pinnacle::Types::SendFormOptions }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/send_form_via_rcs_request_fallback.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # When RCS is unavailable on the recipient's device, fall back to SMS from this number. Requires `to`.
+    class SendFormViaRcsRequestFallback < Internal::Types::Model
+      field :from, -> { String }, optional: false, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/send_form_via_rcs_request_form.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Existing form id or an inline definition that mints a new form for this send.
+    class SendFormViaRcsRequestForm < Internal::Types::Model
+      extend Pinnacle::Internal::Types::Union
+
+      member -> { String }
+      member -> { Pinnacle::Types::FormDefinition }
+    end
+  end
+end

data/lib/pinnacle/types/send_form_via_sms_params.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Send a form from a phone number. `from` must be an E.164 phone.
+    class SendFormViaSmsParams < Internal::Types::Model
+      field :from, -> { String }, optional: false, nullable: false
+      field :to, -> { String }, optional: true, nullable: false
+      field :form, -> { Pinnacle::Types::SendFormViaSmsRequestForm }, optional: false, nullable: false
+      field :options, -> { Pinnacle::Types::SendFormOptions }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/send_form_via_sms_request_form.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    class SendFormViaSmsRequestForm < Internal::Types::Model
+      extend Pinnacle::Internal::Types::Union
+
+      member -> { String }
+      member -> { Pinnacle::Types::FormDefinition }
+    end
+  end
+end

data/lib/pinnacle/types/send_rich_cards_options.rb

@@ -2,7 +2,12 @@
 
 module Pinnacle
   module Types
+    # Configure how your RCS message is sent and tracked.
     class SendRichCardsOptions < Internal::Types::Model
+      field :schedule, -> { Pinnacle::Types::MessageSchedule }, optional: true, nullable: false
+      field :tracking, -> { Pinnacle::Types::Tracking }, optional: true, nullable: false
+      field :transcode, -> { Internal::Types::Boolean }, optional: true, nullable: false
+      field :validate, -> { Internal::Types::Boolean }, optional: true, nullable: false
       field :standalone_card, -> { Pinnacle::Types::RichStandaloneCardOptions }, optional: true, nullable: false
     end
   end

data/lib/pinnacle/types/send_rich_message_options_4.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Configure how your RCS message is sent and tracked.
+    class SendRichMessageOptions4 < Internal::Types::Model
+      field :schedule, -> { Pinnacle::Types::MessageSchedule }, optional: true, nullable: false
+      field :tracking, -> { Pinnacle::Types::Tracking }, optional: true, nullable: false
+      field :transcode, -> { Internal::Types::Boolean }, optional: true, nullable: false
+      field :validate, -> { Internal::Types::Boolean }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/text_field.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Single-line text input with optional length bounds and regex pattern.
+    class TextField < Internal::Types::Model
+      field :placeholder, -> { String }, optional: true, nullable: false
+      field :pattern, -> { String }, optional: true, nullable: false
+      field :min_length, -> { Integer }, optional: true, nullable: false
+      field :max_length, -> { Integer }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/textarea_field.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Multi-line text input for longer free-form answers.
+    class TextareaField < Internal::Types::Model
+      field :placeholder, -> { String }, optional: true, nullable: false
+      field :pattern, -> { String }, optional: true, nullable: false
+      field :min_length, -> { Integer }, optional: true, nullable: false
+      field :max_length, -> { Integer }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/time_field.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # Time picker. `min`/`max` accept `HH:MM` (24-hour).
+    class TimeField < Internal::Types::Model
+      field :placeholder, -> { String }, optional: true, nullable: false
+      field :min, -> { String }, optional: true, nullable: false
+      field :max, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/url_field.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Pinnacle
+  module Types
+    # URL input. Server requires a valid absolute URL.
+    class UrlField < Internal::Types::Model
+      field :placeholder, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/pinnacle/types/vcard_content.rb

@@ -3,7 +3,7 @@
 module Pinnacle
   module Types
     class VcardContent < Internal::Types::Model
-      field :revision, -> { String }, optional: true, nullable: false
+      field :revision, -> { String }, optional: false, nullable: false
     end
   end
 end

data/lib/pinnacle/types/webhook_event_enum.rb

@@ -8,6 +8,7 @@ module Pinnacle
       MESSAGE_STATUS = "MESSAGE.STATUS"
       MESSAGE_RECEIVED = "MESSAGE.RECEIVED"
       USER_TYPING = "USER.TYPING"
+      FORM_SUBMISSION = "FORM.SUBMISSION"
     end
   end
 end

data/lib/pinnacle/types/webhook_summary.rb

@@ -9,6 +9,7 @@ module Pinnacle
       field :status, -> { Pinnacle::Types::WebhookSummaryStatus }, optional: false, nullable: false
       field :created_at, -> { String }, optional: false, nullable: false, api_name: "createdAt"
       field :updated_at, -> { String }, optional: false, nullable: false, api_name: "updatedAt"
+      field :headers, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
     end
   end
 end

data/lib/pinnacle/types/webhooks.rb

@@ -7,6 +7,7 @@ module Pinnacle
       field :endpoint, -> { String }, optional: false, nullable: false
       field :id, -> { String }, optional: false, nullable: false
       field :name, -> { String }, optional: false, nullable: false
+      field :headers, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
     end
   end
 end

data/lib/pinnacle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pinnacle
-  VERSION = "2.0.15"
+  VERSION = "2.0.16.pre.rc.2"
 end

data/lib/pinnacle/webhooks/client.rb

@@ -85,7 +85,13 @@ module Pinnacle
       # Supports bulk operations with up to 50 senders per request. <br>
       #
       # Subscriptions are additive — attaching new senders does not remove existing ones. Re-attaching the same sender
-      # updates the event type filter without creating duplicates.
+      # updates the event type filter without creating duplicates. <br>
+      #
+      # **Custom headers** may be provided in either case via the optional `headers` field. When attaching a new
+      # webhook, the headers are stored on the webhook and sent on every delivery. When attaching an existing
+      # `webhookId`, supplying `headers` **overwrites** the stored headers on that webhook — omit the field to leave
+      # them unchanged, or pass an empty object `{}` to clear them. The reserved `PINNACLE-SIGNING-SECRET` header is
+      # always set by Pinnacle and cannot be overridden.
       #
       # @param request_options [Hash]
       # @param params [Pinnacle::Webhooks::Types::AttachWebhookParams]

data/lib/pinnacle/webhooks/types/attach_webhook_params.rb

@@ -9,6 +9,7 @@ module Pinnacle
         field :name, -> { String }, optional: true, nullable: false
         field :url, -> { String }, optional: true, nullable: false
         field :event, -> { Pinnacle::Types::WebhookEventEnum }, optional: true, nullable: false
+        field :headers, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
       end
     end
   end

data/lib/pinnacle/wrapper/messages/client.rb

@@ -19,7 +19,7 @@ module Pinnacle
         # @param request [Hash] Request with :headers and :body keys
         # @param secret [String, nil] Webhook secret (falls back to PINNACLE_SIGNING_SECRET env var)
         #
-        # @return [Pinnacle::Types::MessageEvent, Pinnacle::Types::UserEvent]
+        # @return [Pinnacle::Types::MessageEvent, Pinnacle::Types::UserEvent, Pinnacle::Types::FormSubmissionEvent]
         # @raise [Pinnacle::Errors::UnauthorizedError] If webhook signature is invalid or missing
         # @raise [Pinnacle::Errors::ClientError] If request body cannot be parsed
         def process(request, secret: nil)
@@ -55,8 +55,11 @@ module Pinnacle
 
           parsed = body.is_a?(String) ? JSON.parse(body) : body
 
-          if parsed["type"] == "USER.TYPING"
+          case parsed["type"]
+          when "USER.TYPING"
             Pinnacle::Types::UserEvent.coerce(parsed)
+          when "FORM.SUBMISSION"
+            Pinnacle::Types::FormSubmissionEvent.coerce(parsed)
           else
             Pinnacle::Types::MessageEvent.coerce(parsed)
           end