sendly 3.30.0 → 3.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0aa8097776c931f504cc3f006783ed8232691fc48c35c93b8930437c9f5480b5
-  data.tar.gz: 74cfe38cea2edefae5a4173dbbae2ff4df2a3364e69de2329191ef95fd26195b
+  metadata.gz: d643b13d3d51b1ce011b394a31a7fb722c26110e12a87d717e407709bdfd687b
+  data.tar.gz: e17abd7c0fa512116b06fb02927e9f8b3c41d2e082f214b48657b15fb0e327e3
 SHA512:
-  metadata.gz: 40d6bb9e8df8757fa585253b39b49e85973f7959f1278b8354c803b293047bb0dbf279dafd5c5550e61d4b6a26ed78ada5295ab686a312dc32f026d46ff7203f
-  data.tar.gz: b4ee727e07b7fc3fa75326e36ae073c62d50e6d3c98b5905c745444c80d6dd358ab19a5ed36c0853af3c07eba7fbba50d6db7389f469c3555abf15d6960b5742
+  metadata.gz: 9a5808b5f638300369e98c7746a049cb5633e727f70648e16f40486564bdb5920731feb3a7a97ebec1580f92bff8ceddca4c8795a224e0ce1c1873f51d9dd3cc
+  data.tar.gz: 1523973847432c7aa50947f6bf46763987d8be1130df68c318fdae466680d18477dece25cfb56200d4f4120cd772f157046b3410cb3284355634bd851efeda3e

data/CHANGELOG.md

@@ -1,5 +1,79 @@
 # sendly (Ruby)
 
+## 3.32.0
+
+### Minor Changes
+
+- New `business_upgrade` resource for the toll-free entity-upgrade ("fork-with-new-number") flow. When a customer forms a new legal entity (e.g. an LLC), this resource lets them reserve a new toll-free number under the new entity, submit it for carrier review, and atomically swap to it on approval — without disrupting outbound SMS during the 1-2 week review window. Mirrors the Node SDK's `businessUpgrade` resource at parity.
+
+  ```ruby
+  client = Sendly::Client.new("sk_live_v1_xxx")
+
+  # Validate before submitting (no writes)
+  preview = client.business_upgrade.preflight(
+    business_name: "Acme Holdings LLC",
+    brn: "12-3456789",
+    brn_type: "EIN",
+    brn_country: "US",
+    entity_type: "PRIVATE_PROFIT"
+  )
+
+  # Best-of prefill across all the caller's verified workspaces
+  prefill = client.business_upgrade.best_prefill
+
+  # Submit the upgrade with the IRS letter (multipart upload)
+  result = client.business_upgrade.start(
+    "ws_abc",
+    business_name: "Acme Holdings LLC",
+    brn: "12-3456789",
+    brn_type: "EIN",
+    brn_country: "US",
+    entity_type: "PRIVATE_PROFIT",
+    ein_doc_path: "./CP-575.pdf"
+  )
+
+  # Status, cancel, resubmit, set old-number disposition
+  client.business_upgrade.status("ws_abc")
+  client.business_upgrade.cancel("ws_abc")
+  client.business_upgrade.resubmit("ws_abc", contact_email: "new@acme.com")
+  client.business_upgrade.set_disposition("ws_abc", disposition: "released")
+  client.business_upgrade.set_disposition("ws_abc", disposition: "moved", target_workspace_id: "ws_xyz")
+  ```
+
+  Methods: `preflight`, `best_prefill`, `start`, `status`, `cancel`, `resubmit`, `set_disposition`. EIN PDFs can be passed via `ein_doc_path:` (file path) or `ein_doc:` (raw bytes / IO).
+
+## 3.31.0
+
+### Patch Changes
+
+- **`Sendly::Client.new` now accepts the API key positionally** in addition to as a keyword argument. Every code sample in our docs used positional, so `Sendly::Client.new("sk_live_...")` previously raised `ArgumentError: missing keyword: :api_key`. Both styles now work and produce identical clients:
+
+  ```ruby
+  # Positional (matches our docs)
+  client = Sendly::Client.new("sk_live_v1_xxx")
+  client = Sendly::Client.new("sk_live_v1_xxx", timeout: 60)
+
+  # Keyword (existing v3.30.0 signature — unchanged)
+  client = Sendly::Client.new(api_key: "sk_live_v1_xxx")
+  ```
+
+  Passing `api_key` both positionally and as a keyword raises `ArgumentError`; passing more than one positional argument also raises. Backward-compatible with all v3.30.0 callers.
+
+## 3.30.0
+
+### Minor Changes
+
+- `enterprise.workspaces.submit_verification(workspace_id, **fields)`: rewritten to match the actual API shape (camelCase keys on the wire, nested `address`/`contact` hashes, `entity_type` + `brn`/`brn_type`/`brn_country` instead of `business_type`/`ein`). The previous shape didn't match the server endpoint — calls were always returning 400.
+- **Partial-update friendly:** for resubmits on existing workspaces, send only the fields you want to change — everything else is filled from the existing record. Hosted page URLs (`/biz/`, `/opt-in/`, `/legal/`) generated during provision are auto-preserved.
+- `enterprise.workspaces.resubmit_verification(workspace_id, **partial_updates)`: convenience alias for resubmits — same as `submit_verification` but reads more naturally for one-field-change use cases.
+- All top-level keys are accepted as snake_case Ruby keyword arguments (`business_name`, `use_case`, `opt_in_workflow`, etc.) and transformed to the camelCase keys the API expects. Nested `address` and `contact` hashes are passed through verbatim and should already use camelCase keys (e.g. `firstName`, `lastName`).
+
+### Server-side fixes paired with this release
+
+- `/api/v1/enterprise/workspaces/:id/verification/submit` now returns specific missing-field errors (e.g. `"Missing required fields: website"`) instead of listing every required field whether present or not.
+- Endpoint accepts both flat and `{ verification: {...} }` wrapped shapes (matches `/enterprise/provision`).
+- `use_case` validation expanded from 23 entries to the full 43-value Telnyx enum.
+
 ## 3.29.0
 
 ### Minor Changes

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    sendly (3.30.0)
+    sendly (3.33.0)
       faraday (~> 2.0)
       faraday-retry (~> 2.0)
 

data/README.md

@@ -164,16 +164,16 @@ scheduled = client.messages.schedule(
 puts scheduled.id
 puts scheduled.scheduled_at
 
-# List scheduled messages
+# List scheduled messages (returns a Hash with "data" array)
 result = client.messages.list_scheduled
-result.data.each { |msg| puts "#{msg.id}: #{msg.scheduled_at}" }
+result["data"].each { |msg| puts "#{msg['id']}: #{msg['scheduledAt']}" }
 
 # Get a specific scheduled message
 msg = client.messages.get_scheduled("sched_xxx")
 
 # Cancel a scheduled message (refunds credits)
 result = client.messages.cancel_scheduled("sched_xxx")
-puts "Refunded: #{result.credits_refunded} credits"
+puts "Refunded: #{result['creditsRefunded']} credits"
 ```
 
 ### Batch Messages
@@ -188,10 +188,10 @@ batch = client.messages.send_batch(
   ]
 )
 
-puts batch.batch_id
-puts "Queued: #{batch.queued}"
-puts "Failed: #{batch.failed}"
-puts "Credits used: #{batch.credits_used}"
+puts batch["batchId"]
+puts "Queued: #{batch['queued']}"
+puts "Failed: #{batch['failed']}"
+puts "Credits used: #{batch['creditsUsed']}"
 
 # Get batch status
 status = client.messages.get_batch("batch_xxx")
@@ -206,8 +206,8 @@ preview = client.messages.preview_batch(
     { to: '+447700900123', text: 'Hello UK!' }
   ]
 )
-puts "Total credits needed: #{preview.total_credits}"
-puts "Valid: #{preview.valid}, Invalid: #{preview.invalid}"
+puts "Credits needed: #{preview['creditsNeeded']}"
+puts "Will send: #{preview['willSend']}, Blocked: #{preview['blocked']}"
 ```
 
 ### Iterate All Messages
@@ -266,30 +266,26 @@ account = client.account.get
 puts account.email
 
 # Check credit balance
-credits = client.account.get_credits
-puts "Available: #{credits.available_balance} credits"
-puts "Reserved: #{credits.reserved_balance} credits"
-puts "Total: #{credits.balance} credits"
+credits = client.account.credits
+puts "Available: #{credits['availableBalance']} credits"
+puts "Reserved: #{credits['reservedBalance']} credits"
+puts "Total: #{credits['balance']} credits"
 
 # View credit transaction history
-result = client.account.get_credit_transactions
-result.data.each do |tx|
-  puts "#{tx.type}: #{tx.amount} credits - #{tx.description}"
+transactions = client.account.transactions
+transactions.each do |tx|
+  puts "#{tx['type']}: #{tx['amount']} credits - #{tx['description']}"
 end
 
 # List API keys
-result = client.account.list_api_keys
-result.data.each do |key|
-  puts "#{key.name}: #{key.prefix}*** (#{key.type})"
+keys = client.account.api_keys
+keys.each do |key|
+  puts "#{key['name']}: #{key['prefix']}*** (#{key['type']})"
 end
 
 # Create a new API key
-new_key = client.account.create_api_key(
-  name: 'Production Key',
-  type: 'live',
-  scopes: ['sms:send', 'sms:read']
-)
-puts "New key: #{new_key.key}"  # Only shown once!
+result = client.account.create_api_key('Production Key')
+puts "New key: #{result['key']}"  # Only shown once!
 
 # Revoke an API key
 client.account.revoke_api_key('key_xxx')
@@ -408,7 +404,7 @@ Three provisioning modes:
 ### Workspace Management
 
 ```ruby
-ws = client.enterprise.workspaces.create("Acme Insurance")
+ws = client.enterprise.workspaces.create(name: "Acme Insurance")
 list = client.enterprise.workspaces.list
 detail = client.enterprise.workspaces.get("ws_xxx")
 client.enterprise.workspaces.delete("ws_xxx")
@@ -430,7 +426,7 @@ client.enterprise.workspaces.revoke_key("ws_xxx", "key_abc")
 ### Webhooks & Analytics
 
 ```ruby
-client.enterprise.webhooks.set("https://yourapp.com/webhooks")
+client.enterprise.webhooks.set(url: "https://yourapp.com/webhooks")
 overview = client.enterprise.analytics.overview
 messages = client.enterprise.analytics.messages(period: "30d")
 delivery = client.enterprise.analytics.delivery

data/lib/sendly/business_upgrade_resource.rb

@@ -0,0 +1,404 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+require "securerandom"
+
+module Sendly
+  # Business Upgrade resource — Entity-Upgrade ("fork-with-new-number")
+  #
+  # Manages the toll-free business entity upgrade flow: when a customer
+  # forms a new legal entity (e.g. an LLC), this resource lets them
+  # reserve a new toll-free number under the new entity, submit it for
+  # carrier review, and atomically swap to it on approval — without
+  # disrupting outbound SMS during the 1-2 week review window.
+  #
+  # @see https://sendly.live/docs/business-upgrade
+  #
+  # @example Validate before submitting
+  #   preview = client.business_upgrade.preflight(
+  #     business_name: "Acme Holdings LLC",
+  #     brn: "12-3456789",
+  #     brn_type: "EIN",
+  #     brn_country: "US",
+  #     entity_type: "PRIVATE_PROFIT"
+  #   )
+  #
+  # @example Submit an upgrade with the IRS letter
+  #   result = client.business_upgrade.start(
+  #     "ws_abc",
+  #     business_name: "Acme Holdings LLC",
+  #     brn: "12-3456789",
+  #     brn_type: "EIN",
+  #     brn_country: "US",
+  #     entity_type: "PRIVATE_PROFIT",
+  #     ein_doc_path: "./CP-575.pdf"
+  #   )
+  class BusinessUpgradeResource
+    # Entity types accepted by the carrier
+    ENTITY_TYPES = %w[
+      SOLE_PROPRIETOR
+      PRIVATE_PROFIT
+      PUBLIC_PROFIT
+      NON_PROFIT
+      GOVERNMENT
+    ].freeze
+
+    # Business Registration Number types
+    BRN_TYPES = %w[EIN SSN DUNS CRA VAT LEI OTHER].freeze
+
+    # Disposition options for the old toll-free number after approval
+    DISPOSITIONS = %w[moved released].freeze
+
+    def initialize(client)
+      @client = client
+    end
+
+    # Validate a candidate entity upgrade payload before submission.
+    # Returns issues + proposed auto-fixes. No writes — purely advisory.
+    #
+    # Accepts the same fields as +start+. Returns a hash with
+    # +verdict+ (+"ready"+, +"warnings"+, +"blocked"+), +issues+, and
+    # +proposedFixes+.
+    #
+    # @param business_name [String, nil]
+    # @param brn [String, nil]
+    # @param brn_type [String, nil] One of {BRN_TYPES}
+    # @param brn_country [String, nil] ISO country code
+    # @param entity_type [String, nil] One of {ENTITY_TYPES}
+    # @param doing_business_as [String, nil]
+    # @param website [String, nil]
+    # @param address1 [String, nil]
+    # @param address2 [String, nil]
+    # @param city [String, nil]
+    # @param state [String, nil]
+    # @param zip [String, nil]
+    # @param address_country [String, nil]
+    # @param contact_first_name [String, nil]
+    # @param contact_last_name [String, nil]
+    # @param contact_email [String, nil]
+    # @param contact_phone [String, nil]
+    # @param monthly_volume [String, nil]
+    # @param use_case [String, nil]
+    # @param use_case_summary [String, nil]
+    # @param sample_messages [String, nil]
+    # @param opt_in_workflow [String, nil]
+    # @param privacy_url [String, nil]
+    # @param terms_url [String, nil]
+    # @param additional_information [String, nil]
+    # @param age_gated_content [Boolean, nil]
+    # @return [Hash] Preflight report
+    def preflight(business_name: nil, brn: nil, brn_type: nil, brn_country: nil,
+                  entity_type: nil, doing_business_as: nil, website: nil,
+                  address1: nil, address2: nil, city: nil, state: nil, zip: nil,
+                  address_country: nil, contact_first_name: nil,
+                  contact_last_name: nil, contact_email: nil, contact_phone: nil,
+                  monthly_volume: nil, use_case: nil, use_case_summary: nil,
+                  sample_messages: nil, opt_in_workflow: nil, privacy_url: nil,
+                  terms_url: nil, additional_information: nil,
+                  age_gated_content: nil)
+      body = build_upgrade_body(
+        business_name: business_name, brn: brn, brn_type: brn_type,
+        brn_country: brn_country, entity_type: entity_type,
+        doing_business_as: doing_business_as, website: website,
+        address1: address1, address2: address2, city: city, state: state,
+        zip: zip, address_country: address_country,
+        contact_first_name: contact_first_name,
+        contact_last_name: contact_last_name, contact_email: contact_email,
+        contact_phone: contact_phone, monthly_volume: monthly_volume,
+        use_case: use_case, use_case_summary: use_case_summary,
+        sample_messages: sample_messages, opt_in_workflow: opt_in_workflow,
+        privacy_url: privacy_url, terms_url: terms_url,
+        additional_information: additional_information,
+        age_gated_content: age_gated_content
+      )
+
+      @client.post("/verification/preflight", body)
+    end
+
+    # Get a "best-of" prefill across all the caller's verified workspaces.
+    # Returns most-recent non-empty values per messaging field. Use this
+    # to pre-populate the upgrade form for users whose current workspace
+    # has incomplete data.
+    #
+    # @return [Hash] +{ "prefill" => {...}, "sourceWorkspaceCount" => Integer }+
+    def best_prefill
+      @client.get("/verification/best-prefill")
+    end
+
+    # Start an entity upgrade for the given workspace. Auto-provisions
+    # a new toll-free number + messaging profile and submits to the
+    # carrier for review. Returns the pending verification details.
+    #
+    # The current toll-free number continues sending throughout the
+    # 1-2 week carrier review; on approval, an atomic swap promotes
+    # the new number.
+    #
+    # The EIN document (when supplied) is uploaded as multipart form-data
+    # under the +einDoc+ field. Provide either +ein_doc_path+ (a path on
+    # disk) or +ein_doc+ (raw bytes / IO) — not both.
+    #
+    # @param workspace_id [String]
+    # @param business_name [String]
+    # @param brn [String]
+    # @param brn_type [String] One of {BRN_TYPES}
+    # @param brn_country [String] ISO country code
+    # @param entity_type [String] One of {ENTITY_TYPES}
+    # @param ein_doc_path [String, nil] Path to the EIN/CP-575 PDF
+    # @param ein_doc [String, IO, nil] Raw EIN PDF bytes or IO
+    # @param ein_doc_filename [String, nil] Filename (defaults to "ein-doc.pdf")
+    # @param ein_doc_content_type [String, nil] MIME type (defaults to "application/pdf")
+    # @return [Hash] Upgrade start response
+    def start(workspace_id, business_name:, brn:, brn_type:, brn_country:,
+              entity_type:, doing_business_as: nil, website: nil,
+              address1: nil, address2: nil, city: nil, state: nil, zip: nil,
+              address_country: nil, contact_first_name: nil,
+              contact_last_name: nil, contact_email: nil, contact_phone: nil,
+              monthly_volume: nil, use_case: nil, use_case_summary: nil,
+              sample_messages: nil, opt_in_workflow: nil, privacy_url: nil,
+              terms_url: nil, additional_information: nil,
+              age_gated_content: nil, ein_doc_path: nil, ein_doc: nil,
+              ein_doc_filename: nil, ein_doc_content_type: nil)
+      raise ArgumentError, "Workspace ID is required" if workspace_id.nil? || workspace_id.empty?
+
+      fields = build_upgrade_body(
+        business_name: business_name, brn: brn, brn_type: brn_type,
+        brn_country: brn_country, entity_type: entity_type,
+        doing_business_as: doing_business_as, website: website,
+        address1: address1, address2: address2, city: city, state: state,
+        zip: zip, address_country: address_country,
+        contact_first_name: contact_first_name,
+        contact_last_name: contact_last_name, contact_email: contact_email,
+        contact_phone: contact_phone, monthly_volume: monthly_volume,
+        use_case: use_case, use_case_summary: use_case_summary,
+        sample_messages: sample_messages, opt_in_workflow: opt_in_workflow,
+        privacy_url: privacy_url, terms_url: terms_url,
+        additional_information: additional_information,
+        age_gated_content: age_gated_content
+      )
+
+      post_multipart_with_fields(
+        "/workspaces/#{url_escape(workspace_id)}/upgrade",
+        fields,
+        ein_doc_path: ein_doc_path,
+        ein_doc: ein_doc,
+        ein_doc_filename: ein_doc_filename,
+        ein_doc_content_type: ein_doc_content_type
+      )
+    end
+
+    # Check whether the given workspace has a pending entity upgrade.
+    # Returns +{ "pending" => nil }+ when no upgrade is in flight.
+    #
+    # @param workspace_id [String]
+    # @return [Hash]
+    def status(workspace_id)
+      raise ArgumentError, "Workspace ID is required" if workspace_id.nil? || workspace_id.empty?
+
+      @client.get("/workspaces/#{url_escape(workspace_id)}/upgrade/status")
+    end
+
+    # Cancel a pending entity upgrade for the given workspace. Releases
+    # the reserved toll-free number, deletes the new messaging profile,
+    # and removes the stored EIN document. Idempotent.
+    #
+    # @param workspace_id [String]
+    # @return [Hash]
+    def cancel(workspace_id)
+      raise ArgumentError, "Workspace ID is required" if workspace_id.nil? || workspace_id.empty?
+
+      @client.post("/workspaces/#{url_escape(workspace_id)}/upgrade/cancel", {})
+    end
+
+    # Resubmit a rejected (or waiting-for-customer) entity upgrade with
+    # updated fields and optionally a new EIN document. All fields are
+    # optional — only the ones you pass are sent.
+    #
+    # @param workspace_id [String]
+    # @return [Hash]
+    def resubmit(workspace_id, business_name: nil, brn: nil, brn_type: nil,
+                 brn_country: nil, entity_type: nil, doing_business_as: nil,
+                 website: nil, address1: nil, address2: nil, city: nil,
+                 state: nil, zip: nil, address_country: nil,
+                 contact_first_name: nil, contact_last_name: nil,
+                 contact_email: nil, contact_phone: nil, monthly_volume: nil,
+                 use_case: nil, use_case_summary: nil, sample_messages: nil,
+                 opt_in_workflow: nil, privacy_url: nil, terms_url: nil,
+                 additional_information: nil, age_gated_content: nil,
+                 ein_doc_path: nil, ein_doc: nil, ein_doc_filename: nil,
+                 ein_doc_content_type: nil)
+      raise ArgumentError, "Workspace ID is required" if workspace_id.nil? || workspace_id.empty?
+
+      fields = build_upgrade_body(
+        business_name: business_name, brn: brn, brn_type: brn_type,
+        brn_country: brn_country, entity_type: entity_type,
+        doing_business_as: doing_business_as, website: website,
+        address1: address1, address2: address2, city: city, state: state,
+        zip: zip, address_country: address_country,
+        contact_first_name: contact_first_name,
+        contact_last_name: contact_last_name, contact_email: contact_email,
+        contact_phone: contact_phone, monthly_volume: monthly_volume,
+        use_case: use_case, use_case_summary: use_case_summary,
+        sample_messages: sample_messages, opt_in_workflow: opt_in_workflow,
+        privacy_url: privacy_url, terms_url: terms_url,
+        additional_information: additional_information,
+        age_gated_content: age_gated_content
+      )
+
+      post_multipart_with_fields(
+        "/workspaces/#{url_escape(workspace_id)}/upgrade/resubmit",
+        fields,
+        ein_doc_path: ein_doc_path,
+        ein_doc: ein_doc,
+        ein_doc_filename: ein_doc_filename,
+        ein_doc_content_type: ein_doc_content_type
+      )
+    end
+
+    # After a successful entity-upgrade approval, choose what happens to
+    # the old toll-free number:
+    #
+    # - +"moved"+: keep it active under another workspace owned by the
+    #   same user (requires +target_workspace_id+)
+    # - +"released"+: return it to the carrier pool
+    #
+    # @param workspace_id [String]
+    # @param disposition [String] +"moved"+ or +"released"+
+    # @param target_workspace_id [String, nil] Required when +disposition+ is +"moved"+
+    # @return [Hash]
+    def set_disposition(workspace_id, disposition:, target_workspace_id: nil)
+      raise ArgumentError, "Workspace ID is required" if workspace_id.nil? || workspace_id.empty?
+      unless DISPOSITIONS.include?(disposition)
+        raise ArgumentError, "disposition must be one of: #{DISPOSITIONS.join(", ")}"
+      end
+      if disposition == "moved" && (target_workspace_id.nil? || target_workspace_id.empty?)
+        raise ArgumentError, "target_workspace_id is required when disposition is 'moved'"
+      end
+
+      body = { disposition: disposition }
+      body[:targetOrgId] = target_workspace_id if target_workspace_id
+
+      @client.post("/workspaces/#{url_escape(workspace_id)}/upgrade/disposition", body)
+    end
+
+    private
+
+    def url_escape(value)
+      URI.encode_www_form_component(value)
+    end
+
+    def build_upgrade_body(business_name:, brn:, brn_type:, brn_country:,
+                           entity_type:, doing_business_as:, website:,
+                           address1:, address2:, city:, state:, zip:,
+                           address_country:, contact_first_name:,
+                           contact_last_name:, contact_email:, contact_phone:,
+                           monthly_volume:, use_case:, use_case_summary:,
+                           sample_messages:, opt_in_workflow:, privacy_url:,
+                           terms_url:, additional_information:,
+                           age_gated_content:)
+      body = {}
+      body[:businessName] = business_name unless business_name.nil?
+      body[:brn] = brn unless brn.nil?
+      body[:brnType] = brn_type unless brn_type.nil?
+      body[:brnCountry] = brn_country unless brn_country.nil?
+      body[:entityType] = entity_type unless entity_type.nil?
+      body[:doingBusinessAs] = doing_business_as unless doing_business_as.nil?
+      body[:website] = website unless website.nil?
+      body[:address1] = address1 unless address1.nil?
+      body[:address2] = address2 unless address2.nil?
+      body[:city] = city unless city.nil?
+      body[:state] = state unless state.nil?
+      body[:zip] = zip unless zip.nil?
+      body[:addressCountry] = address_country unless address_country.nil?
+      body[:contactFirstName] = contact_first_name unless contact_first_name.nil?
+      body[:contactLastName] = contact_last_name unless contact_last_name.nil?
+      body[:contactEmail] = contact_email unless contact_email.nil?
+      body[:contactPhone] = contact_phone unless contact_phone.nil?
+      body[:monthlyVolume] = monthly_volume unless monthly_volume.nil?
+      body[:useCase] = use_case unless use_case.nil?
+      body[:useCaseSummary] = use_case_summary unless use_case_summary.nil?
+      body[:sampleMessages] = sample_messages unless sample_messages.nil?
+      body[:optInWorkflow] = opt_in_workflow unless opt_in_workflow.nil?
+      body[:privacyUrl] = privacy_url unless privacy_url.nil?
+      body[:termsUrl] = terms_url unless terms_url.nil?
+      body[:additionalInformation] = additional_information unless additional_information.nil?
+      body[:ageGatedContent] = age_gated_content unless age_gated_content.nil?
+      body
+    end
+
+    # POST a multipart/form-data request with the given fields plus an
+    # optional +einDoc+ file part. Mirrors the JSON-vs-multipart flexibility
+    # the server expects: if no EIN doc is supplied and there are no fields,
+    # we still send an empty multipart body (the server is configured for
+    # +multer+ on these routes).
+    def post_multipart_with_fields(path, fields, ein_doc_path:, ein_doc:,
+                                   ein_doc_filename:, ein_doc_content_type:)
+      if !ein_doc_path.nil? && !ein_doc.nil?
+        raise ArgumentError, "Provide ein_doc_path OR ein_doc, not both"
+      end
+
+      file_bytes = nil
+      filename = ein_doc_filename || "ein-doc.pdf"
+      content_type = ein_doc_content_type || "application/pdf"
+
+      if ein_doc_path
+        raise ArgumentError, "File not found: #{ein_doc_path}" unless File.exist?(ein_doc_path)
+        file_bytes = File.binread(ein_doc_path)
+        filename = ein_doc_filename || File.basename(ein_doc_path)
+      elsif ein_doc
+        file_bytes = ein_doc.is_a?(String) ? ein_doc : ein_doc.read
+      end
+
+      boundary = "SendlyRuby#{SecureRandom.hex(16)}"
+      body_parts = []
+
+      fields.each do |k, v|
+        next if v.nil?
+        body_parts << "--#{boundary}\r\n"
+        body_parts << "Content-Disposition: form-data; name=\"#{k}\"\r\n\r\n"
+        body_parts << (v == true || v == false ? v.to_s : v.to_s)
+        body_parts << "\r\n"
+      end
+
+      if file_bytes
+        body_parts << "--#{boundary}\r\n"
+        body_parts << "Content-Disposition: form-data; name=\"einDoc\"; filename=\"#{filename}\"\r\n"
+        body_parts << "Content-Type: #{content_type}\r\n\r\n"
+        body_parts << file_bytes
+        body_parts << "\r\n"
+      end
+
+      body_parts << "--#{boundary}--\r\n"
+
+      uri = URI.parse("#{@client.base_url}#{path}")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = 10
+      http.read_timeout = @client.timeout
+
+      req = Net::HTTP::Post.new(uri)
+      req["Authorization"] = "Bearer #{@client.api_key}"
+      req["Accept"] = "application/json"
+      req["User-Agent"] = "sendly-ruby/#{Sendly::VERSION}"
+      req["Content-Type"] = "multipart/form-data; boundary=#{boundary}"
+      req["X-Organization-Id"] = @client.organization_id if @client.organization_id
+      req.body = body_parts.join
+
+      begin
+        response = http.request(req)
+      rescue Net::OpenTimeout, Net::ReadTimeout
+        raise Sendly::TimeoutError, "Request timed out after #{@client.timeout} seconds"
+      rescue Errno::ECONNREFUSED, Errno::ECONNRESET, SocketError => e
+        raise Sendly::NetworkError, "Connection failed: #{e.message}"
+      end
+
+      status = response.code.to_i
+      body = response.body.nil? || response.body.empty? ? {} : (JSON.parse(response.body) rescue { "message" => response.body })
+
+      return body if status >= 200 && status < 300
+
+      raise Sendly::ErrorFactory.from_response(status, body)
+    end
+  end
+end

data/lib/sendly/client.rb

@@ -23,18 +23,33 @@ module Sendly
     # @return [String, nil] Organization ID
     attr_accessor :organization_id
 
-    # Create a new Sendly client
+    # Create a new Sendly client.
     #
-    # @param api_key [String] Your Sendly API key
-    # @param base_url [String] API base URL (optional)
+    # Two calling conventions are supported (both produce the same client):
+    #
+    #   # Positional (matches Sendly's published code samples and the
+    #   # idiom of most other Ruby HTTP SDKs):
+    #   client = Sendly::Client.new("sk_live_v1_xxx")
+    #   client = Sendly::Client.new("sk_live_v1_xxx", timeout: 60)
+    #
+    #   # Keyword (existing v3.30.0 signature):
+    #   client = Sendly::Client.new(api_key: "sk_live_v1_xxx")
+    #
+    # @param api_key [String, nil] Your Sendly API key (also accepted as positional)
+    # @param base_url [String, nil] API base URL (optional)
     # @param timeout [Integer] Request timeout in seconds (default: 30)
     # @param max_retries [Integer] Maximum retry attempts (default: 3)
     # @param organization_id [String, nil] Organization ID (optional)
-    #
-    # @example
-    #   client = Sendly::Client.new("sk_live_v1_xxx")
-    #   client = Sendly::Client.new("sk_live_v1_xxx", timeout: 60, max_retries: 5)
-    def initialize(api_key:, base_url: nil, timeout: 30, max_retries: 3, organization_id: nil)
+    def initialize(*args, api_key: nil, base_url: nil, timeout: 30, max_retries: 3, organization_id: nil)
+      # Backward-compatible positional API key. Previously this constructor
+      # only accepted `api_key:` as a keyword; every code sample in our
+      # docs used positional, breaking copy-paste for new users.
+      if !args.empty?
+        raise ArgumentError, "Sendly::Client.new accepts at most one positional argument (api_key)" if args.length > 1
+        raise ArgumentError, "Cannot pass api_key both positionally and as keyword" unless api_key.nil?
+        api_key = args.first
+      end
+
       @api_key = api_key
       @base_url = (base_url || Sendly.base_url).chomp("/")
       @timeout = timeout
@@ -135,6 +150,13 @@ module Sendly
       @enterprise ||= EnterpriseResource.new(self)
     end
 
+    # Access the Business Upgrade resource (entity-upgrade flow)
+    #
+    # @return [Sendly::BusinessUpgradeResource]
+    def business_upgrade
+      @business_upgrade ||= BusinessUpgradeResource.new(self)
+    end
+
     # Make a GET request
     #
     # @param path [String] API path

data/lib/sendly/enterprise.rb

@@ -31,25 +31,77 @@ module Sendly
       @client.delete("/enterprise/workspaces/#{workspace_id}")
     end
 
-    def submit_verification(workspace_id, business_name:, business_type:, ein:, address:, city:, state:, zip:, use_case:, sample_messages:, monthly_volume: nil)
+    # Submit (or resubmit) a verification for an enterprise workspace.
+    #
+    # Partial-update friendly (May 2026): for resubmit on an existing
+    # workspace, you only need to send the fields you want to change —
+    # everything else is preserved from the existing record. Hosted page
+    # URLs (/biz/, /opt-in/, /legal/) generated during provision are
+    # auto-preserved.
+    #
+    # For sole proprietors, leave brn/brn_type/brn_country nil — the
+    # server strips them before forwarding to the carrier.
+    #
+    # Accepts snake_case keyword arguments which are transformed to the
+    # camelCase keys the API expects. Nested +address+ and +contact+
+    # hashes should already use camelCase keys (e.g. +firstName+,
+    # +lastName+) since they are passed through verbatim.
+    #
+    # Example (full submit):
+    #
+    #   client.enterprise.workspaces.submit_verification(workspace_id,
+    #     business_name: "Acme LLC",
+    #     website: "https://acme.com",
+    #     address: { street: "...", city: "...", state: "California", zip: "90001", country: "US" },
+    #     contact: { firstName: "...", lastName: "...", email: "...", phone: "+15551234567" },
+    #     use_case: "Insurance Services",
+    #     use_case_summary: "...",
+    #     sample_messages: "...",
+    #     opt_in_workflow: "...",
+    #     entity_type: "SOLE_PROPRIETOR")
+    #
+    # Example (partial-update resubmit, only changing email):
+    #
+    #   client.enterprise.workspaces.submit_verification(workspace_id,
+    #     contact: { email: "new@email.com" })
+    def submit_verification(workspace_id, business_name: nil, doing_business_as: nil, website: nil, entity_type: nil, address: nil, contact: nil, brn: nil, brn_type: nil, brn_country: nil, use_case: nil, use_case_summary: nil, sample_messages: nil, opt_in_workflow: nil, opt_in_image_urls: nil, monthly_volume: nil, additional_information: nil, age_gated_content: nil, isv_reseller: nil, privacy_url: nil, terms_url: nil)
       raise ArgumentError, "Workspace ID is required" if workspace_id.nil? || workspace_id.empty?
 
-      body = {
-        business_name: business_name,
-        business_type: business_type,
-        ein: ein,
-        address: address,
-        city: city,
-        state: state,
-        zip: zip,
-        use_case: use_case,
-        sample_messages: sample_messages
-      }
-      body[:monthly_volume] = monthly_volume if monthly_volume
+      body = {}
+      body[:businessName] = business_name unless business_name.nil?
+      body[:doingBusinessAs] = doing_business_as unless doing_business_as.nil?
+      body[:website] = website unless website.nil?
+      body[:entityType] = entity_type unless entity_type.nil?
+      body[:address] = address unless address.nil?
+      body[:contact] = contact unless contact.nil?
+      body[:brn] = brn unless brn.nil?
+      body[:brnType] = brn_type unless brn_type.nil?
+      body[:brnCountry] = brn_country unless brn_country.nil?
+      body[:useCase] = use_case unless use_case.nil?
+      body[:useCaseSummary] = use_case_summary unless use_case_summary.nil?
+      body[:sampleMessages] = sample_messages unless sample_messages.nil?
+      body[:optInWorkflow] = opt_in_workflow unless opt_in_workflow.nil?
+      body[:optInImageUrls] = opt_in_image_urls unless opt_in_image_urls.nil?
+      body[:monthlyVolume] = monthly_volume unless monthly_volume.nil?
+      body[:additionalInformation] = additional_information unless additional_information.nil?
+      body[:ageGatedContent] = age_gated_content unless age_gated_content.nil?
+      body[:isvReseller] = isv_reseller unless isv_reseller.nil?
+      body[:privacyUrl] = privacy_url unless privacy_url.nil?
+      body[:termsUrl] = terms_url unless terms_url.nil?
 
       @client.post("/enterprise/workspaces/#{workspace_id}/verification/submit", body)
     end
 
+    # Convenience alias for resubmits. Identical to +submit_verification+
+    # but reads more naturally when you only want to update a few fields
+    # after a rejection.
+    #
+    #   client.enterprise.workspaces.resubmit_verification(workspace_id,
+    #     contact: { email: "new@email.com" })
+    def resubmit_verification(workspace_id, **partial_updates)
+      submit_verification(workspace_id, **partial_updates)
+    end
+
     def inherit_verification(workspace_id, source_workspace_id:)
       raise ArgumentError, "Workspace ID is required" if workspace_id.nil? || workspace_id.empty?
       raise ArgumentError, "Source workspace ID is required" if source_workspace_id.nil? || source_workspace_id.empty?

data/lib/sendly/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sendly
-  VERSION = "3.30.0"
+  VERSION = "3.33.0"
 end

data/lib/sendly.rb

@@ -21,6 +21,7 @@ require_relative "sendly/labels_resource"
 require_relative "sendly/drafts_resource"
 require_relative "sendly/rules_resource"
 require_relative "sendly/enterprise"
+require_relative "sendly/business_upgrade_resource"
 
 # Sendly Ruby SDK
 #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendly
 version: !ruby/object:Gem::Version
-  version: 3.30.0
+  version: 3.33.0
 platform: ruby
 authors:
 - Sendly
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-05-01 00:00:00.000000000 Z
+date: 2026-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -125,6 +125,7 @@ files:
 - examples/send_sms.rb
 - lib/sendly.rb
 - lib/sendly/account_resource.rb
+- lib/sendly/business_upgrade_resource.rb
 - lib/sendly/campaigns_resource.rb
 - lib/sendly/client.rb
 - lib/sendly/contacts_resource.rb