calendly 0.11.1 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ce5444bfb8db3d61a37abcbe3c42ce2cf517b00c00f865148e00bc543011d7a
-  data.tar.gz: 3f6ed1de7cd5c2bbbb28047ba54a143e37ce44e4455326eb9981e52c575c86fc
+  metadata.gz: 7e93c2dc16d8ea8b5c14d890394dbaf898935d1ac3bfa85d091056be51fc5e30
+  data.tar.gz: 49b3c47b087a73d2fb86e00e301daa7661bf0b5d0bf3014142806dd64006f9a5
 SHA512:
-  metadata.gz: fe02a87e62592413d76fcf5d25a8bb49acc01b232a7454b631a03a42fd4cd0ceedbf289542bc72c7ffafbd11dad101fe2b31d6b6d3156e2e075d1ecb55a46e5c
-  data.tar.gz: a084d2938851edebb77e55b5c4db0305eceac26cb1ed1f92c8e7b5b4a79791976a4e56f00267e3035f46c59a71a58614eab994235f1e1887cb3b4c58168cdce6
+  metadata.gz: 5e1d557c0df74d1ab77237bbea0199c0771576d780fac4e91147ee06cdbf7d215536220ff643b3167f026437c04ba650368f810cc3d554425c05eeb817b71d9e
+  data.tar.gz: 69d38a1904609257682374b562d3c45fc3cba63fdfab4654c83fa1739c1bb14bbbfb308a8b9a2a3aa1fdda69263a8fde3cc12e0d857d518e5ef0587c2963a7d0

data/CHANGELOG.md

@@ -1,15 +1,34 @@
 # CHANGELOG
 
+## 0.12.0 - 2022-07-16
+
+- supported Routing Form APIs. (#55)
+  - `GET /routing_forms`
+  - `GET /routing_forms/{uuid}`
+  - `GET /routing_form_submissions`
+  - `GET /routing_form_submissions/{uuid}`
+  - changed were followings:
+    - Client
+      - (Add method) routing_form
+      - (Add method) routing_forms
+      - (Add method) routing_form_submission
+      - (Add method) routing_form_submissions
+    - Organization model
+      - (Add method) routing_forms
+      - (Add method) routing_forms!
+    - Invitee model
+      - (Add field) routing_form_submission
+
 ## 0.11.1 - 2022-06-29
 
 - specified dependencies:
-  - oauth2: 1.x series (refs #53)
-  - faraday: 1.x or 2.x seriese (refs #51)
+  - oauth2: 1.x series (#53)
+  - faraday: 1.x or 2.x seriese (#50)
 
 ## 0.11.0 - 2022-05-02
 
 - supported a API `POST /scheduled_events/{uuid}/cancellation`. (#48)
-  - changed files:
+  - changed were followings:
     - Client
       - (Add method) cancel_event
     - Event
@@ -19,7 +38,7 @@
 ## 0.10.0 - 2022-04-15
 
 - supported a API `POST /data_compliance/deletion/invitees`. (#28)
-  - changed files:
+  - changed were followings:
     - Client
       - (Add method) delete_invitee_data
 
@@ -29,7 +48,7 @@
   - `GET /invitee_no_shows/{no_show_uuid}`
   - `POST /invitee_no_shows`
   - `DELETE /invitee_no_shows/{no_show_uuid}`
-  - changed files:
+  - changed were followings:
     - Client
       - (Add method) invitee_no_show
       - (Add method) create_invitee_no_show
@@ -56,7 +75,7 @@
 ## 0.8.0 - 2021-06-03
 
 - used keyword arguments for optional parameters, to be friendly for programmer.
-- changed methods are followings:
+- changed methods were followings:
   - Client
     - event_types
     - event_types_by_user

data/README.md

@@ -104,14 +104,15 @@ invitation.delete
 The webhook usage is below.
 
 ```ruby
-events = ['invitee.created', 'invitee.canceled']
 url = 'https://example.com/received_event'
+subscribable_user_events = ['invitee.created', 'invitee.canceled']
+subscribable_org_events = ['invitee.created', 'invitee.canceled', 'routing_form_submission.created']
 
 #
 # create a user scope webhook
 #
 me = client.me
-user_webhook = me.create_webhook(url, events)
+user_webhook = me.create_webhook(url, subscribable_user_events)
 # => #<Calendly::WebhookSubscription uuid="USER_WEBHOOK_001", state="active", scope="user", events=["invitee.created", "invitee.canceled"], callback_url="https://example.com/received_event", ..>
 
 # list of user scope webhooks
@@ -126,8 +127,8 @@ user_webhook.delete
 # create an organization scope webhook
 #
 org = client.me.current_organization
-org_webhook = org.create_webhook(url, events)
-# => #<Calendly::WebhookSubscription uuid="ORG_WEBHOOK_001", state="active", scope="organization", events=["invitee.created", "invitee.canceled"], callback_url="https://example.com/received_event", ..>
+org_webhook = org.create_webhook(url, subscribable_org_events)
+# => #<Calendly::WebhookSubscription uuid="ORG_WEBHOOK_001", state="active", scope="organization", events=["invitee.created", "invitee.canceled", "routing_form_submission.created"], callback_url="https://example.com/received_event", ..>
 
 # list of organization scope webhooks
 org.webhooks

data/calendly.gemspec

@@ -28,8 +28,8 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_runtime_dependency 'oauth2', '~> 1.4', '>= 1.4.4'
   spec.add_runtime_dependency 'faraday', '>= 1.0.0', '< 3.0.0'
+  spec.add_runtime_dependency 'oauth2', '~> 1.4', '>= 1.4.4'
 
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'codecov'

data/lib/calendly/client.rb

@@ -113,7 +113,7 @@ module Calendly
     # @option options [String] :page_token Pass this to get the next portion of collection.
     # @option options [String] :sort Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values.
     # @return [Array<Array<Calendly::EventType>, Hash>]
-    #  - [Array<Calendly::EventType>] event_types
+    #  - [Array<Calendly::EventType>] event types
     #  - [Hash] next_params the parameters to get next data. if thre is no next it returns nil.
     # @raise [Calendly::Error] if the org_uri arg is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
@@ -141,7 +141,7 @@ module Calendly
     # @option options [String] :page_token Pass this to get the next portion of collection.
     # @option options [String] :sort Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values.
     # @return [Array<Array<Calendly::EventType>, Hash>]
-    #  - [Array<Calendly::EventType>] event_types
+    #  - [Array<Calendly::EventType>] event types
     #  - [Hash] next_params the parameters to get next data. if thre is no next it returns nil.
     # @raise [Calendly::Error] if the user_uri arg is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
@@ -210,7 +210,7 @@ module Calendly
     # @param [String] uuid the event's unique indentifier.
     # @param [Hash] options the optional request parameters. Optional.
     # @option options [String] :reason reason for cancellation.
-    # @return [InviteeCancellation]
+    # @return [Calendly::InviteeCancellation]
     # @raise [Calendly::Error] if the uuid arg is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.11.0
@@ -609,7 +609,7 @@ module Calendly
     # Create a webhook subscription for an organization or user.
     #
     # @param [String] url Canonical reference (unique identifier) for the resource.
-    # @param [Array<String>] events List of user events to subscribe to. options: invitee.created or invitee.canceled
+    # @param [Array<String>] events List of user events to subscribe to. options: invitee.created or invitee.canceled or routing_form_submission.created
     # @param [String] org_uri The unique reference to the organization that the webhook will be tied to.
     # @param [String] user_uri The unique reference to the user that the webhook will be tied to. Optional.
     # @param [String] signing_key secret key shared between your application and Calendly. Optional.
@@ -651,6 +651,88 @@ module Calendly
       true
     end
 
+    #
+    # Get a specified Routing Form.
+    #
+    # @param [String] uuid the specified routing form (routing form's uuid).
+    # @return [Calendly::RoutingForm]
+    # @raise [Calendly::Error] if the uuid arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.12.0
+    def routing_form(uuid)
+      check_not_empty uuid, 'uuid'
+      body = request :get, "routing_forms/#{uuid}"
+      RoutingForm.new body[:resource], self
+    end
+
+    #
+    # Get a list of Routing Forms for a specified Organization.
+    #
+    # @param [String] org_uri the specified organization (organization's uri).
+    # @param [Hash] options the optional request parameters. Optional.
+    # @option options [Integer] :count Number of rows to return.
+    # @option options [String] :page_token Pass this to get the next portion of collection.
+    # @option options [String] :sort Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values.
+    # @return [Array<Array<Calendly::RoutingForm>, Hash>]
+    #  - [Array<Calendly::RoutingForm>] routing forms
+    #  - [Hash] next_params the parameters to get next data. if thre is no next it returns nil.
+    # @raise [Calendly::Error] if the org_uri arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.12.0
+    def routing_forms(org_uri, options: nil)
+      check_not_empty org_uri, 'org_uri'
+
+      opts_keys = %i[count page_token sort]
+      params = {organization: org_uri}
+      params = merge_options options, opts_keys, params
+      body = request :get, 'routing_forms', params: params
+
+      items = body[:collection] || []
+      forms = items.map { |item| RoutingForm.new item, self }
+      [forms, next_page_params(body)]
+    end
+
+    #
+    # Get a specified Routing Form Submission.
+    #
+    # @param [String] uuid the specified routing form submission (routing form submission's uuid).
+    # @return [Calendly::RoutingFormSubmission]
+    # @raise [Calendly::Error] if the uuid arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.12.0
+    def routing_form_submission(uuid)
+      check_not_empty uuid, 'uuid'
+      body = request :get, "routing_form_submissions/#{uuid}"
+      RoutingFormSubmission.new body[:resource], self
+    end
+
+    #
+    # Get a list of Routing Form Submissions for a specified Routing Form.
+    #
+    # @param [String] form_uri the specified organization (routing form's uri).
+    # @param [Hash] options the optional request parameters. Optional.
+    # @option options [Integer] :count Number of rows to return.
+    # @option options [String] :page_token Pass this to get the next portion of collection.
+    # @option options [String] :sort Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values.
+    # @return [Array<Array<Calendly::RoutingFormSubmission>, Hash>]
+    #  - [Array<Calendly::RoutingFormSubmission>] routing form submissions
+    #  - [Hash] next_params the parameters to get next data. if thre is no next it returns nil.
+    # @raise [Calendly::Error] if the form_uri arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.12.0
+    def routing_form_submissions(form_uri, options: nil)
+      check_not_empty form_uri, 'form_uri'
+
+      opts_keys = %i[count page_token sort]
+      params = {form: form_uri}
+      params = merge_options options, opts_keys, params
+      body = request :get, 'routing_form_submissions', params: params
+
+      items = body[:collection] || []
+      submissions = items.map { |item| RoutingFormSubmission.new item, self }
+      [submissions, next_page_params(body)]
+    end
+
     #
     # Create a scheduling link.
     #

data/lib/calendly/models/event.rb

@@ -50,15 +50,15 @@ module Calendly
     # Moment when user record was last updated.
     attr_accessor :updated_at
 
-    # @return [EventType]
+    # @return [Calendly::EventType]
     # Reference to Event Type associated with this event.
     attr_accessor :event_type
 
-    # @return [InviteeCancellation]
+    # @return [Calendly::InviteeCancellation]
     # Provides data pertaining to the cancellation of the Invitee.
     attr_accessor :cancellation
 
-    # @return [InviteesCounter]
+    # @return [Calendly::InviteesCounter]
     # invitees counter.
     attr_accessor :invitees_counter
 
@@ -66,11 +66,11 @@ module Calendly
     # location in this event.
     attr_accessor :location
 
-    # @return [Array<User>]
+    # @return [Array<Calendly::User>]
     # Event membership list.
     attr_accessor :event_memberships
 
-    # @return [Array<Guest>]
+    # @return [Array<Calendly::Guest>]
     # Additional people added to an event by an invitee.
     attr_accessor :event_guests
 
@@ -90,7 +90,7 @@ module Calendly
     #
     # @param [Hash] options the optional request parameters. Optional.
     # @option options [String] :reason reason for cancellation.
-    # @return [InviteeCancellation]
+    # @return [Calendly::InviteeCancellation]
     # @raise [Calendly::Error] if the uuid is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.11.0
@@ -104,11 +104,9 @@ module Calendly
     # @param [Hash] options the optional request parameters. Optional.
     # @option options [Integer] :count Number of rows to return.
     # @option options [String] :email Filter by email.
-    # @option options [String] :page_token
-    # Pass this to get the next portion of collection.
-    # @option opts [String] :sort Order results by the specified field and directin.
-    # Accepts comma-separated list of {field}:{direction} values.
-    # @option opts [String] :status Whether the scheduled event is active or canceled.
+    # @option options [String] :page_token Pass this to get the next portion of collection.
+    # @option options [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
+    # @option options [String] :status Whether the scheduled event is active or canceled.
     # @return [Array<Calendly::Invitee>]
     # @raise [Calendly::Error] if the uuid is empty.
     # @raise [Calendly::ApiError] if the api returns error code.

data/lib/calendly/models/event_type.rb

@@ -85,23 +85,23 @@ module Calendly
     # Moment when event type was last updated.
     attr_accessor :updated_at
 
-    # @return [EventTypeProfile]
+    # @return [Calendly::EventTypeProfile]
     # The profile of the User that's associated with the Event Type.
     attr_accessor :profile
 
-    # @return [Array<EventTypeCustomQuestion>]
+    # @return [Array<Calendly::EventTypeCustomQuestion>]
     # A collection of custom questions.
     attr_accessor :custom_questions
 
     # The owner user if the profile belongs to a "user" (individual).
-    # @return [User]
+    # @return [Calendly::User]
     # @since 0.6.0
     def owner_user
       profile&.owner_user
     end
 
     # The owner team if the profile belongs to a "team".
-    # @return [Team]
+    # @return [Calendly::Team]
     # @since 0.6.0
     def owner_team
       profile&.owner_team

data/lib/calendly/models/event_type_profile.rb

@@ -17,11 +17,11 @@ module Calendly
     # The unique reference to the user associated with the profile
     attr_accessor :owner
 
-    # @return [User]
+    # @return [Calendly::User]
     # The owner user if the profile belongs to a "user" (individual).
     attr_accessor :owner_user
 
-    # @return [Team]
+    # @return [Calendly::Team]
     # The owner team if the profile belongs to a "team".
     attr_accessor :owner_team
 

data/lib/calendly/models/invitee.rb

@@ -16,7 +16,8 @@ module Calendly
         payment: InviteePayment,
         no_show: InviteeNoShow,
         questions_and_answers: InviteeQuestionAndAnswer,
-        tracking: InviteeTracking
+        tracking: InviteeTracking,
+        routing_form_submission: RoutingFormSubmission
       }
     end
 
@@ -94,13 +95,13 @@ module Calendly
     # Moment when user record was last updated.
     attr_accessor :updated_at
 
-    # @return [InviteeCancellation] Provides data pertaining to the cancellation of the Invitee.
+    # @return [Calendly::InviteeCancellation] Provides data pertaining to the cancellation of the Invitee.
     attr_accessor :cancellation
 
-    # @return [InviteePayment] Invitee payment.
+    # @return [Calendly::InviteePayment] Invitee payment.
     attr_accessor :payment
 
-    # @return [InviteeNoShow, nil]
+    # @return [Calendly::InviteeNoShow, nil]
     # Provides data pertaining to the associated no show for the Invitee.
     attr_accessor :no_show
 
@@ -115,6 +116,9 @@ module Calendly
     # @return [Calendly::InviteeTracking]
     attr_accessor :tracking
 
+    # @return [Calendly::RoutingFormSubmission, nil]
+    attr_accessor :routing_form_submission
+
     #
     # Get Event Invitee associated with self.
     #

data/lib/calendly/models/invitee_no_show.rb

@@ -25,7 +25,7 @@ module Calendly
     # The moment when the no show was created.
     attr_accessor :created_at
 
-    # @return [Invitee, nil]
+    # @return [Calendly::Invitee, nil]
     # The associated Invitee.
     attr_accessor :invitee
 

data/lib/calendly/models/invitee_tracking.rb

@@ -1,39 +1,9 @@
 # frozen_string_literal: true
 
 module Calendly
-  # Calendly's invitee tracking model.
-  # Object that represents UTM and Salesforce tracking parameters associated with the invitee.
+  # UTM and Salesforce tracking parameters associated with the invitee.
   class InviteeTracking
     include ModelUtils
-
-    # @return [String]
-    # UTM campaign tracking parameter.
-    attr_accessor :utm_campaign
-
-    # @return [String]
-    # UTM source tracking parameter.
-    attr_accessor :utm_source
-
-    # @return [String]
-    # UTM medium tracking parameter.
-    attr_accessor :utm_medium
-
-    # @return [String]
-    # UTM content tracking parameter.
-    attr_accessor :utm_content
-
-    # @return [String]
-    # UTM term tracking parameter.
-    attr_accessor :utm_term
-
-    # @return [String]
-    # Salesforce Record ID.
-    attr_accessor :salesforce_uuid
-
-  private
-
-    def inspect_attributes
-      super + %i[utm_source utm_medium utm_campaign]
-    end
+    include TrackingFields
   end
 end

data/lib/calendly/models/organization.rb

@@ -45,8 +45,7 @@ module Calendly
     # @option options [Integer] :count Number of rows to return.
     # @option options [String] :email Filter by email.
     # @option options [String] :page_token Pass this to get the next portion of collection.
-    # @option options [String] :sort Order results by the specified field and directin.
-    # Accepts comma-separated list of {field}:{direction} values.
+    # @option options [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
     # @option options [String] :status Filter by status.
     # @return [Array<Calendly::OrganizationInvitation>]
     # @raise [Calendly::Error] if the uuid is empty.
@@ -85,8 +84,7 @@ module Calendly
     # @option options [Boolean] :active Return only active event types if true, only inactive if false, or all event types if this parameter is omitted.
     # @option options [Integer] :count Number of rows to return.
     # @option options [String] :page_token Pass this to get the next portion of collection.
-    # @option options [String] :sort Order results by the specified field and direction.
-    # Accepts comma-separated list of {field}:{direction} values.
+    # @option options [String] :sort Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values.
     # @return [Array<Calendly::EventType>]
     # @raise [Calendly::Error] if the uri is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
@@ -113,8 +111,7 @@ module Calendly
     # @option options [String] :max_start_timeUpper bound (inclusive) for an event's start time to filter by.
     # @option options [String] :min_start_time Lower bound (inclusive) for an event's start time to filter by.
     # @option options [String] :page_token Pass this to get the next portion of collection.
-    # @option options [String] :sort Order results by the specified field and directin.
-    # Accepts comma-separated list of {field}:{direction} values.
+    # @option options [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
     # @option options [String] :status Whether the scheduled event is active or canceled
     # @return [Array<Calendly::Event>]
     # @raise [Calendly::Error] if the uri is empty.
@@ -140,7 +137,6 @@ module Calendly
     # @option options [Integer] :count Number of rows to return.
     # @option options [String] :page_token Pass this to get the next portion of collection.
     # @option options [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
-    # Accepts comma-separated list of {field}:{direction} values.
     # @return [Array<Calendly::WebhookSubscription>]
     # @raise [Calendly::Error] if the uri is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
@@ -173,5 +169,29 @@ module Calendly
     def create_webhook(url, events, signing_key: nil)
       client.create_webhook url, events, uri, signing_key: signing_key
     end
+
+    #
+    # Returns all Routing Forms associated with self.
+    #
+    # @param [Hash] options the optional request parameters. Optional.
+    # @option options [Integer] :count Number of rows to return.
+    # @option options [String] :page_token Pass this to get the next portion of collection.
+    # @option options [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
+    # @return [Array<Calendly::RoutingForm>]
+    # @raise [Calendly::Error] if the uri is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.12.0
+    def routing_forms(options: nil)
+      return @cached_routing_forms if defined?(@cached_routing_forms) && @cached_routing_forms
+
+      request_proc = proc { |opts| client.routing_forms uri, options: opts }
+      @cached_routing_forms = auto_pagination request_proc, options
+    end
+
+    # @since 0.12.0
+    def routing_forms!(options: nil)
+      @cached_routing_forms = nil
+      routing_forms options: options
+    end
   end
 end

data/lib/calendly/models/organization_invitation.rb

@@ -42,11 +42,11 @@ module Calendly
     # Moment when the last invitation was sent.
     attr_accessor :last_sent_at
 
-    # @return [Organization]
+    # @return [Calendly::Organization]
     # Reference to Organization associated with this invitation.
     attr_accessor :organization
 
-    # @return [User]
+    # @return [Calendly::User]
     # If a person accepted the invitation, a reference to their User.
     attr_accessor :user
 

data/lib/calendly/models/organization_membership.rb

@@ -38,7 +38,7 @@ module Calendly
     # Primary account details of a specific user.
     attr_accessor :user
 
-    # @return [Organization]
+    # @return [Calendly::Organization]
     # Reference to Organization associated with this membership.
     attr_accessor :organization
 
@@ -70,7 +70,6 @@ module Calendly
     # @option options [Integer] :count Number of rows to return.
     # @option options [String] :page_token Pass this to get the next portion of collection.
     # @option options [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
-    # Accepts comma-separated list of {field}:{direction} values.
     # @return [Array<Calendly::WebhookSubscription>]
     # @raise [Calendly::Error] if the organization.uri is empty.
     # @raise [Calendly::Error] if the user.uri is empty.

data/lib/calendly/models/routing_form.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Calendly
+  # Calendly's routing form model.
+  class RoutingForm
+    include ModelUtils
+    UUID_RE = %r{\A#{Client::API_HOST}/routing_forms/(#{UUID_FORMAT})\z}.freeze
+    TIME_FIELDS = %i[created_at updated_at].freeze
+
+    def self.association
+      {
+        organization: Organization,
+        questions: RoutingFormQuestion
+      }
+    end
+
+    # @return [String]
+    # unique id of the RoutingForm object.
+    attr_accessor :uuid
+
+    # @return [String]
+    # Canonical reference (unique identifier) for the routing form.
+    attr_accessor :uri
+
+    # @return [String]
+    # The routing form name (in human-readable format).
+    attr_accessor :name
+
+    # @return [String]
+    # Indicates if the form is in "draft" or "published" status.
+    attr_accessor :status
+
+    # @return [Time]
+    # Moment when user record was first created.
+    attr_accessor :created_at
+
+    # @return [Time]
+    # Moment when user record was last updated.
+    attr_accessor :updated_at
+
+    # @return [Calendly::Organization]
+    # The URI of the organization that's associated with the routing form.
+    attr_accessor :organization
+
+    # @return [Calendly::RoutingFormQuestion]
+    # An ordered collection of Routing Form non-deleted questions.
+    attr_accessor :questions
+
+    #
+    # Get Routing Form associated with self.
+    #
+    # @return [Calendly::RoutingForm]
+    # @raise [Calendly::Error] if the uuid is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.12.0
+    def fetch
+      client.routing_form uuid
+    end
+
+    #
+    # Returns all Routing Form Submissions associated with self.
+    #
+    # @param [Hash] options the optional request parameters. Optional.
+    # @option options [Integer] :count Number of rows to return.
+    # @option options [String] :page_token Pass this to get the next portion of collection.
+    # @option options [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
+    # @return [Array<Calendly::RoutingFormSubmission>]
+    # @raise [Calendly::Error] if the uri is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.12.0
+    def submissions(options: nil)
+      return @cached_submissions if defined?(@cached_submissions) && @cached_submissions
+
+      request_proc = proc { |opts| client.routing_form_submissions uri, options: opts }
+      @cached_submissions = auto_pagination request_proc, options
+    end
+
+    # @since 0.12.0
+    def submissions!(options: nil)
+      @cached_submissions = nil
+      submissions options: options
+    end
+  end
+end

data/lib/calendly/models/routing_form_question.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Calendly
+  # Calendly's routing form question model.
+  class RoutingFormQuestion
+    include ModelUtils
+    TIME_FIELDS = %i[created_at updated_at].freeze
+
+    # @return [String]
+    # Unique identifier for the routing form question.
+    attr_accessor :uuid
+
+    # @return [String]
+    # Question name (in human-readable format).
+    attr_accessor :name
+
+    # @return [String]
+    # Question type: name, text input, email, phone, textarea input, dropdown list or radio button list.
+    attr_accessor :type
+
+    # @return [Boolean]
+    # true if an answer to the question is required for respondents to submit the routing form; false if not required.
+    attr_accessor :required
+
+    # @return [Array<String>]
+    # The respondent’s option(s) for "select" or "radios" types of questions.
+    attr_accessor :answer_choices
+  end
+end

data/lib/calendly/models/routing_form_submission.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Calendly
+  # Calendly's routing form submission model.
+  class RoutingFormSubmission
+    include ModelUtils
+    UUID_RE = %r{\A#{Client::API_HOST}/routing_form_submissions/(#{UUID_FORMAT})\z}.freeze
+    TIME_FIELDS = %i[created_at updated_at].freeze
+
+    def self.association
+      {
+        routing_form: RoutingForm,
+        questions_and_answers: RoutingFormSubmissionQuestionAndAnswer,
+        tracking: RoutingFormSubmissionTracking,
+        result: RoutingFormSubmissionEventTypeResult
+      }
+    end
+
+    # @return [String]
+    # unique id of the RoutingFormSubmission object.
+    attr_accessor :uuid
+
+    # @return [String]
+    # Canonical reference (unique identifier) for the routing form submission.
+    attr_accessor :uri
+
+    # @return [String, nil]
+    # The reference to the Invitee resource when routing form submission results in a scheduled meeting.
+    attr_accessor :submitter
+
+    # @return [String, nil]
+    # Type of the respondent resource that submitted the form and scheduled a meeting.
+    attr_accessor :submitter_type
+
+    # @return [Time]
+    # Moment when user record was first created.
+    attr_accessor :created_at
+
+    # @return [Time]
+    # Moment when user record was last updated.
+    attr_accessor :updated_at
+
+    # @return [Calendly::RoutingForm]
+    # The routing form that's associated with the submission.
+    attr_accessor :routing_form
+
+    # @return [Array<Calendly::RoutingFormSubmissionQuestionAndAnswer>]
+    # All Routing Form Submission questions with answers.
+    attr_accessor :questions_and_answers
+
+    # @return [Calendly::RoutingFormSubmissionTracking]
+    # All Routing Form Submission questions with answers.
+    attr_accessor :tracking
+
+    # @return [Calendly::RoutingFormSubmissionEventTypeResult]
+    # Information about the event type Routing Form Submission result.
+    attr_accessor :result
+
+    #
+    # Get Routing Form Submission associated with self.
+    #
+    # @return [Calendly::RoutingFormSubmission]
+    # @raise [Calendly::Error] if the uuid is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.12.0
+    def fetch
+      client.routing_form_submission uuid
+    end
+  end
+end

data/lib/calendly/models/routing_form_submission_event_type_result.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Calendly
+  # Event type Routing Form Submission result.
+  class RoutingFormSubmissionEventTypeResult
+    include ModelUtils
+
+    # @return [String]
+    # If the type is event_type, indicates that the routing form submission resulted in a redirect to an event type booking page.
+    # If the type is external_url, indicates that the routing form submission resulted in a redirect to an external URL.
+    # If the type is custom_message, indicates if the routing form submission resulted in a custom "thank you" message.
+    attr_accessor :type
+
+    # @return [String, Hash]
+    # If the type is event_type, a reference to the event type resource.
+    # If the type is external_url, the external URL the respondent were redirected to.
+    # If the type is custom_message, contains an Hash with custom message headline and body.
+    attr_accessor :value
+  end
+end

data/lib/calendly/models/routing_form_submission_question_and_answer.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Calendly
+  # Routing Form Submission question with answer.
+  class RoutingFormSubmissionQuestionAndAnswer
+    include ModelUtils
+
+    # @return [String]
+    # Unique identifier for the routing form question.
+    attr_accessor :question_uuid
+    alias uuid question_uuid
+
+    # @return [String]
+    # Question name (in human-readable format).
+    attr_accessor :question
+
+    # @return [String]
+    # Answer provided by the respondent when the form was submitted.
+    attr_accessor :answer
+
+  private
+
+    def inspect_attributes
+      super + %i[question]
+    end
+  end
+end

data/lib/calendly/models/routing_form_submission_tracking.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Calendly
+  # UTM and Salesforce tracking parameters associated with a Routing Form Submission.
+  class RoutingFormSubmissionTracking
+    include ModelUtils
+    include TrackingFields
+  end
+end

data/lib/calendly/models/tracking_fields.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Calendly
+  # UTM and Salesforce tracking parameters.
+  module TrackingFields
+    # @return [String]
+    # UTM campaign tracking parameter.
+    attr_accessor :utm_campaign
+
+    # @return [String]
+    # UTM source tracking parameter.
+    attr_accessor :utm_source
+
+    # @return [String]
+    # UTM medium tracking parameter.
+    attr_accessor :utm_medium
+
+    # @return [String]
+    # UTM content tracking parameter.
+    attr_accessor :utm_content
+
+    # @return [String]
+    # UTM term tracking parameter.
+    attr_accessor :utm_term
+
+    # @return [String]
+    # Salesforce Record ID.
+    attr_accessor :salesforce_uuid
+
+  private
+
+    def inspect_attributes
+      super + %i[utm_source utm_medium utm_campaign]
+    end
+  end
+end

data/lib/calendly/models/user.rb

@@ -54,7 +54,7 @@ module Calendly
     # Moment when user record was last updated.
     attr_accessor :updated_at
 
-    # @return [Organization]
+    # @return [Calendly::Organization]
     # user's current organization
     attr_accessor :current_organization
 
@@ -97,8 +97,7 @@ module Calendly
     # @option options [Boolean] :active Return only active event types if true, only inactive if false, or all event types if this parameter is omitted.
     # @option options [Integer] :count Number of rows to return.
     # @option options [String] :page_token Pass this to get the next portion of collection.
-    # @option options [String] :sort Order results by the specified field and direction.
-    # Accepts comma-separated list of {field}:{direction} values.
+    # @option options [String] :sort Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values.
     # @return [Array<Calendly::EventType>]
     # @raise [Calendly::Error] if the uri is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
@@ -125,8 +124,7 @@ module Calendly
     # @option options [String] :max_start_timeUpper bound (inclusive) for an event's start time to filter by.
     # @option options [String] :min_start_time Lower bound (inclusive) for an event's start time to filter by.
     # @option options [String] :page_token Pass this to get the next portion of collection.
-    # @option options [String] :sort Order results by the specified field and directin.
-    # Accepts comma-separated list of {field}:{direction} values.
+    # @option options [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
     # @option options [String] :status Whether the scheduled event is active or canceled
     # @return [Array<Calendly::Event>]
     # @raise [Calendly::Error] if the uri is empty.
@@ -152,7 +150,6 @@ module Calendly
     # @option options [Integer] :count Number of rows to return.
     # @option options [String] :page_token Pass this to get the next portion of collection.
     # @option options [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
-    # Accepts comma-separated list of {field}:{direction} values.
     # @return [Array<Calendly::WebhookSubscription>]
     # @raise [Calendly::Error] if the organization.uri is empty.
     # @raise [Calendly::Error] if the uri is empty.

data/lib/calendly/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Calendly
-  VERSION = '0.11.1'
+  VERSION = '0.12.0'
 end

data/lib/calendly.rb

@@ -2,6 +2,7 @@
 
 require 'calendly/client'
 require 'calendly/models/model_utils'
+require 'calendly/models/tracking_fields'
 Dir[
   File.join(
     File.dirname(__FILE__),

metadata

@@ -1,55 +1,55 @@
 --- !ruby/object:Gem::Specification
 name: calendly
 version: !ruby/object:Gem::Version
-  version: 0.11.1
+  version: 0.12.0
 platform: ruby
 authors:
 - Kenji Koshikawa
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-06-29 00:00:00.000000000 Z
+date: 2022-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: oauth2
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.4'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.4.4
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.4'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.4.4
+        version: 1.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
 - !ruby/object:Gem::Dependency
-  name: faraday
+  name: oauth2
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
-    - - "<"
+        version: '1.4'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 1.4.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0
-    - - "<"
+        version: '1.4'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 1.4.4
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -191,7 +191,14 @@ files:
 - lib/calendly/models/organization.rb
 - lib/calendly/models/organization_invitation.rb
 - lib/calendly/models/organization_membership.rb
+- lib/calendly/models/routing_form.rb
+- lib/calendly/models/routing_form_question.rb
+- lib/calendly/models/routing_form_submission.rb
+- lib/calendly/models/routing_form_submission_event_type_result.rb
+- lib/calendly/models/routing_form_submission_question_and_answer.rb
+- lib/calendly/models/routing_form_submission_tracking.rb
 - lib/calendly/models/team.rb
+- lib/calendly/models/tracking_fields.rb
 - lib/calendly/models/user.rb
 - lib/calendly/models/webhook_subscription.rb
 - lib/calendly/version.rb
@@ -202,7 +209,7 @@ metadata:
   homepage_uri: https://github.com/koshilife/calendly-api-ruby-client
   source_code_uri: https://github.com/koshilife/calendly-api-ruby-client
   changelog_uri: https://github.com/koshilife/calendly-api-ruby-client/blob/master/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/calendly/0.11.1
+  documentation_uri: https://www.rubydoc.info/gems/calendly/0.12.0
 post_install_message: 
 rdoc_options: []
 require_paths: