calendly 0.5.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed9a6a6603eff87ea16541bd352c82516ca1fb69b1e517d7e08b2a433c9a2764
-  data.tar.gz: 502ddb8c46807e459f0b3ee4179e853912ea1eab1091a0526decda51f4b1ee6a
+  metadata.gz: 5e6b1e9a3e025d825c0fea46f89e00bff03a5ff64e075fae3794022aad9d6271
+  data.tar.gz: efb1c10ff8a3e73f4799193a6225c31bfa74d200969699c305cb7aa815c09890
 SHA512:
-  metadata.gz: 9c2dd02c24e48b0db78ff0e687c6934700d30392e382d8dd8f0559aeb2a4caa00e76351b80575b086ecb95e2d6d33ae339e70e623b1831463ff71ae956d46b4e
-  data.tar.gz: 256e9711d23191ec8dc5cfbc5893f31deb98975d85fcdaccf74d2c86cca1537922848f64443474614345a3b283e24d205c3d0408c396dffd1e7e75c89812e91a
+  metadata.gz: 6543fec0b13503100c112334d7fe2a32b9bfd69b263064334c52a7ac622ec6f16c0345b222b8d5e94e12912fbbbd841ea26328a5ccd36bdc27b8eb2103a1da0d
+  data.tar.gz: c86ce5d7a1e7ccf1f60dd3a210aea4435e19910592ca75c7e7da5c357fbd7ab8aaec9e05f3a132c3b89bd9f481c560ec090151e719d21fe72a997b9e6855ef3c

data/CHANGELOG.md

@@ -1,5 +1,98 @@
 # CHANGELOG
 
+## 0.8.0
+
+- used keyword arguments for optional parameters, to be friendly for programmer.
+- changed methods are followings:
+  - Client
+    - event_types
+    - event_types_by_user
+    - scheduled_events
+    - scheduled_events_by_user
+    - event_invitees
+    - memberships
+    - memberships_by_user
+    - invitations
+    - webhooks
+    - user_scope_webhooks
+    - create_schedule_link
+  - Event
+    - invitees
+    - invitees!
+  - EventType
+    - create_schedule_link
+  - Organization
+    - memberships
+    - memberships!
+    - invitations
+    - invitations!
+    - event_types
+    - event_types!
+    - scheduled_events
+    - scheduled_events!
+    - webhooks
+    - webhooks!
+  - OrganizationMembership
+    - user_scope_webhooks
+    - user_scope_webhooks!
+  - User
+    - event_types
+    - scheduled_events
+    - webhooks
+    - webhooks!
+
+## 0.7.0
+
+- supported a signing key parameter when creating webhooks. (#33)
+- changed `user_uri` argument to keyword argument on Client#create_webhook.
+
+## 0.6.0
+
+- supported new features until April 2021. (#29)
+  - Client
+    - (Change) support organization options in `event_types` api.
+    - (Rename) `event_types` to `event_types_by_user`
+  - User model
+    - (Add field) current_organization
+    - (Add method) webhooks
+    - (Add method) webhooks!
+    - (Add method) create_webhook
+  - Organization model
+    - (Add method) event_types
+    - (Add method) event_types!
+  - Event model
+    - (Remove field) invitees_counter_total
+    - (Remove field) invitees_counter_active
+    - (Remove field) invitees_counter_limit
+    - (Add field) invitees_counter
+    - (Add field) event_memberships
+    - (Add field) event_guests
+  - EventType model
+    - (Remove field) owner_uuid
+    - (Remove field) owner_uri
+    - (Remove field) owner_name
+    - (Add field) profile
+    - (Add field) secret
+    - (Add field) custom_questions
+    - (Add method) owner_user
+    - (Add method) owner_team
+  - Invitee model
+    - (Add field) first_name
+    - (Add field) last_name
+    - (Add field) cancellation
+    - (Add field) payment
+- fixed debug log encoding error. (#30)
+- improved inspect method to be more readable in CLI.
+
+## 0.5.2
+
+- started to support a API
+  - `POST /scheduling_links`
+
+## 0.5.1
+
+- added method EventType#fetch
+
 ## 0.5.0
 
 - changed Calendly::Client#scheduled_events behavior (refs #21)

data/README.md

@@ -50,21 +50,28 @@ client = Calendly::Client.new '<ACCESS_TOKEN>'
 This client basic usage is below.
 
 ```ruby
+#
 # get a current user's information.
+#
 me = client.me
-# => <Calendly::User uuid:U001>
+# => #<Calendly::User uuid="U001", name="Foo Bar", slug="foobar", email="foobar@example.com", ..>
+
 me.scheduling_url
-# => "https://calendly.com/your_name"
+# => "https://calendly.com/foobar"
 
-# get all Event Types
+#
+# get all event types
+#
 event_types = me.event_types
-# => [#<Calendly::EventType uuid:ET001>, #<Calendly::EventType uuid:ET002>, #<Calendly::EventType uuid:ET003>]
+# => [#<Calendly::EventType uuid="ET001", name="15 Minute Meeting", type="StandardEventType", slug="15min", active=true, kind="solo", scheduling_url="https://calendly.com/foobar/15min", ..>, #<Calendly::EventType uuid="ET002", name="30 Minute Meeting", type="StandardEventType", slug="30min", active=true, kind="solo", scheduling_url="https://calendly.com/foobar/30min", ..>]
 event_types.first.scheduling_url
-# => "https://calendly.com/your_name/30min"
+# => "https://calendly.com/foobar/15min"
 
+#
 # get scheduled events
+#
 events = me.scheduled_events
-# => => [#<Calendly::Event uuid:EV001>, #<Calendly::Event uuid:EV002>, #<Calendly::Event uuid:EV003>]
+# => => [#<Calendly::Event uuid="EV001", name="FooBar Meeting", status="active", ..>, #<Calendly::Event uuid="EV002", name="Team Meeting", status="active", ..>]
 ev = events.first
 ev.name
 # => "FooBar Meeting"
@@ -73,21 +80,23 @@ ev.start_time
 ev.end_time
 # => 2020-07-22 02:00:00 UTC
 
-# get organization information
-own_member = me.organization_membership
-# => #<Calendly::OrganizationMembership uuid:MEM001>
-my_org = own_member.organization
-all_members = my_org.memberships
-# => [#<Calendly::OrganizationMembership uuid:MEM001>, #<Calendly::OrganizationMembership uuid:MEM002>]
+#
+# get a current organization's information
+#
+org = me.current_organization
+# => #<Calendly::Organization uuid="ORG001", ..>
+all_members = org.memberships
+# => [#<Calendly::OrganizationMembership uuid="MEM001", role="owner", ..>, #<Calendly::OrganizationMembership uuid="MEM002", role="user", ..>]
 
+#
 # create new invitation and send invitation email
-invitation = my_org.create_invitation('foobar@example.com')
-# => #<Calendly::OrganizationInvitation uuid:INV001>
-invitation.status
-# => "pending"
+#
+invitation = org.create_invitation('foobar@example.com')
+# => #<Calendly::OrganizationInvitation uuid="INV001", status="pending", email="foobar@example.com", ..>
 
 # cancel the invitation
 invitation.delete
+# => true
 ```
 
 ### Webhook
@@ -96,31 +105,33 @@ The webhook usage is below.
 
 ```ruby
 events = ['invitee.created', 'invitee.canceled']
-own_member = client.me.organization_membership
-org = own_member.organization
-
-# create user scope webhook
 url = 'https://example.com/received_event'
-user_webhook = own_member.create_user_scope_webhook(url, events)
-# => #<Calendly::WebhookSubscription uuid:USER_WEBHOOK_001>
+
+#
+# create a user scope webhook
+#
+me = client.me
+user_webhook = me.create_webhook(url, 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
-own_member.user_scope_webhooks
-# => [#<Calendly::WebhookSubscription uuid:USER_WEBHOOK_001>]
+me.webhooks
+# => [#<Calendly::WebhookSubscription uuid="USER_WEBHOOK_001", state="active", scope="user", events=["invitee.created", "invitee.canceled"], callback_url="https://example.com/received_event", ..>]
 
 # delete the webhook
 user_webhook.delete
 # => true
 
-
-# create organization scope webhook
-url = 'https://example.com/received_event'
+#
+# create an organization scope webhook
+#
+org = client.me.current_organization
 org_webhook = org.create_webhook(url, events)
-# => #<Calendly::WebhookSubscription uuid:ORG_WEBHOOK_001>
+# => #<Calendly::WebhookSubscription uuid="ORG_WEBHOOK_001", state="active", scope="organization", events=["invitee.created", "invitee.canceled"], callback_url="https://example.com/received_event", ..>
 
 # list of organization scope webhooks
 org.webhooks
-# => [#<Calendly::WebhookSubscription uuid:ORG_WEBHOOK_001>]
+# => [#<Calendly::WebhookSubscription uuid="ORG_WEBHOOK_001", state="active", scope="organization", events=["invitee.created", "invitee.canceled"], callback_url="https://example.com/received_event", ..>]
 
 # delete the webhook
 org_webhook.delete
@@ -134,7 +145,7 @@ This library supports a configurable logger.
 ```ruby
 # if the log level set :debug, you can get the request/response information.
 Calendly.configuration.logger.level = :debug
-invitation = my_org.create_invitation('foobar@example.com')
+invitation = org.create_invitation('foobar@example.com')
 # D, [2020-08-10T10:48:15] DEBUG -- : Request POST https://api.calendly.com/organizations/ORG001/invitations params:, body:{:email=>"foobar@example.com"}
 # D, [2020-08-10T10:48:16] DEBUG -- : Response status:201, body:{"resource":{"created_at":"2020-08-10T10:48:16.051159Z","email":"foobar@example.com","last_sent_at":"2020-08-10T10:48:16.096518Z","organization":"https://api.calendly.com/organizations/ORG001","status":"pending","updated_at":"2020-08-10T10:48:16.051159Z","uri":"https://api.calendly.com/organizations/ORG001/invitations/INV001"}}
 ```

data/lib/calendly/api_error.rb

@@ -7,10 +7,13 @@ module Calendly
   class ApiError < Error
     # @return [Faraday::Response]
     attr_reader :response
+
     # @return [Integer]
     attr_reader :status
+
     # @return [String]
     attr_reader :title
+
     # @return [OAuth2::Error, JSON::ParserError]
     attr_reader :cause_exception
 

data/lib/calendly/client.rb

@@ -25,7 +25,7 @@ module Calendly
     # @return [OAuth2::AccessToken]
     # @since 0.0.1
     def access_token
-      return @access_token if defined? @access_token
+      return @access_token if defined?(@access_token) && @access_token
 
       client = OAuth2::Client.new(@config.client_id,
                                   @config.client_secret, client_options)
@@ -59,7 +59,7 @@ module Calendly
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.0.1
     def current_user
-      return @cached_current_user if @cached_current_user
+      return @cached_current_user if defined?(@cached_current_user) && @cached_current_user
 
       @cached_current_user = user
     end
@@ -103,25 +103,52 @@ module Calendly
     end
 
     #
-    # Returns all Event Types associated with a specified User.
+    # Returns all Event Types associated with 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::EventType>, Hash>]
+    #  - [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.
+    # @since 0.6.0
+    def event_types(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, 'event_types', params: params
+
+      items = body[:collection] || []
+      ev_types = items.map { |item| EventType.new item, self }
+      [ev_types, next_page_params(body)]
+    end
+
+    #
+    # Returns all Event Types associated with a specified user.
     #
     # @param [String] user_uri the specified user (user's uri).
-    # @param [Hash] opts the optional request parameters.
-    # @option opts [Integer] :count Number of rows to return.
-    # @option opts [String] :page_token Pass this to get the next portion of collection.
-    # @option opts [String] :sort Order results by the specified field and direction. Accepts comma-separated list of {field}:{direction} values.
+    # @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::EventType>, Hash>]
     #  - [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.
     # @since 0.0.2
-    def event_types(user_uri, opts = {})
+    def event_types_by_user(user_uri, options: nil)
       check_not_empty user_uri, 'user_uri'
 
       opts_keys = %i[count page_token sort]
       params = {user: user_uri}
-      params = merge_options opts, opts_keys, params
+      params = merge_options options, opts_keys, params
       body = request :get, 'event_types', params: params
 
       items = body[:collection] || []
@@ -147,26 +174,26 @@ module Calendly
     # Get List of scheduled events belonging to a specific organization.
     #
     # @param [String] org_uri the specified organization (organization's uri).
-    # @param [Hash] opts the optional request parameters.
-    # @option opts [Integer] :count Number of rows to return.
-    # @option opts [String] :invitee_email Return events scheduled with the specified invitee email.
-    # @option opts [String] :max_start_time Upper bound (inclusive) for an event's start time to filter by.
-    # @option opts [String] :min_start_time Lower bound (inclusive) for an event's start time to filter by.
-    # @option opts [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.
+    # @param [Hash] options the optional request parameters. Optional.
+    # @option options [Integer] :count Number of rows to return.
+    # @option options [String] :invitee_email Return events scheduled with the specified invitee email.
+    # @option options [String] :max_start_time Upper 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] :status Whether the scheduled event is active or canceled.
     # @return [Array<Array<Calendly::Event>, Hash>]
     #  - [Array<Calendly::Event>] events
     #  - [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.5.0
-    def scheduled_events(org_uri, opts = {})
+    def scheduled_events(org_uri, options: nil)
       check_not_empty org_uri, 'org_uri'
 
       opts_keys = %i[count invitee_email max_start_time min_start_time page_token sort status]
       params = {organization: org_uri}
-      params = merge_options opts, opts_keys, params
+      params = merge_options options, opts_keys, params
       body = request :get, 'scheduled_events', params: params
 
       items = body[:collection] || []
@@ -178,27 +205,27 @@ module Calendly
     # Get List of scheduled events belonging to a specific user.
     #
     # @param [String] user_uri the specified user (user's uri).
-    # @param [Hash] opts the optional request parameters.
-    # @option opts [String] :organization the specified organization (organization's uri).
-    # @option opts [Integer] :count Number of rows to return.
-    # @option opts [String] :invitee_email Return events scheduled with the specified invitee email.
-    # @option opts [String] :max_start_time Upper bound (inclusive) for an event's start time to filter by.
-    # @option opts [String] :min_start_time Lower bound (inclusive) for an event's start time to filter by.
-    # @option opts [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.
+    # @param [Hash] options the optional request parameters. Optional.
+    # @option options [String] :organization the specified organization (organization's uri).
+    # @option options [Integer] :count Number of rows to return.
+    # @option options [String] :invitee_email Return events scheduled with the specified invitee email.
+    # @option options [String] :max_start_time Upper 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] :status Whether the scheduled event is active or canceled.
     # @return [Array<Array<Calendly::Event>, Hash>]
     #  - [Array<Calendly::Event>] events
     #  - [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.
     # @since 0.0.3
-    def scheduled_events_by_user(user_uri, opts = {})
+    def scheduled_events_by_user(user_uri, options: nil)
       check_not_empty user_uri, 'user_uri'
 
       opts_keys = %i[organization count invitee_email max_start_time min_start_time page_token sort status]
       params = {user: user_uri}
-      params = merge_options opts, opts_keys, params
+      params = merge_options options, opts_keys, params
       body = request :get, 'scheduled_events', params: params
 
       items = body[:collection] || []
@@ -228,23 +255,23 @@ module Calendly
     # Get List of Event Invitees.
     #
     # @param [String] uuid the specified event (event's uuid).
-    # @param [Hash] opts the optional request parameters.
-    # @option opts [Integer] :count Number of rows to return.
-    # @option opts [String] :email Filter by email.
-    # @option opts [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.
+    # @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 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<Array<Calendly::Invitee>, Hash>]
     #  - [Array<Calendly::Invitee>] invitees
     #  - [Hash] next_params the parameters to get next data. if thre is no next it returns nil.
     # @raise [Calendly::Error] if the uuid arg is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.0.4
-    def event_invitees(uuid, opts = {})
+    def event_invitees(uuid, options: nil)
       check_not_empty uuid, 'uuid'
 
       opts_keys = %i[count email page_token sort status]
-      params = merge_options opts, opts_keys
+      params = merge_options options, opts_keys
       body = request :get, "scheduled_events/#{uuid}/invitees", params: params
 
       items = body[:collection] || []
@@ -270,22 +297,22 @@ module Calendly
     # Get List of memberships belonging to specific an organization.
     #
     # @param [String] org_uri the specified organization (organization's uri).
-    # @param [Hash] opts the optional request parameters.
-    # @option opts [Integer] :count Number of rows to return.
-    # @option opts [String] :email Filter by email.
-    # @option opts [String] :page_token Pass this to get the next portion of collection.
+    # @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.
     # @return [Array<Array<Calendly::OrganizationMembership>, Hash>]
     #  - [Array<Calendly::OrganizationMembership>] memberships
     #  - [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.0.5
-    def memberships(org_uri, opts = {})
+    def memberships(org_uri, options: nil)
       check_not_empty org_uri, 'org_uri'
 
       opts_keys = %i[count email page_token]
       params = {organization: org_uri}
-      params = merge_options opts, opts_keys, params
+      params = merge_options options, opts_keys, params
       body = request :get, 'organization_memberships', params: params
 
       items = body[:collection] || []
@@ -297,22 +324,22 @@ module Calendly
     # Get List of memberships belonging to specific a user.
     #
     # @param [String] user_uri the specified user (user's uri).
-    # @param [Hash] opts the optional request parameters.
-    # @option opts [Integer] :count Number of rows to return.
-    # @option opts [String] :email Filter by email.
-    # @option opts [String] :page_token Pass this to get the next portion of collection.
+    # @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.
     # @return [Array<Array<Calendly::OrganizationMembership>, Hash>]
     #  - [Array<Calendly::OrganizationMembership>] memberships
     #  - [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.
     # @since 0.0.5
-    def memberships_by_user(user_uri, opts = {})
+    def memberships_by_user(user_uri, options: nil)
       check_not_empty user_uri, 'user_uri'
 
       opts_keys = %i[count email page_token]
       params = {user: user_uri}
-      params = merge_options opts, opts_keys, params
+      params = merge_options options, opts_keys, params
       body = request :get, 'organization_memberships', params: params
 
       items = body[:collection] || []
@@ -356,23 +383,23 @@ module Calendly
     # Get Organization Invitations.
     #
     # @param [String] uuid the specified organization (organization's uuid).
-    # @param [Hash] opts the optional request parameters.
-    # @option opts [Integer] :count Number of rows to return.
-    # @option opts [String] :email Filter by email.
-    # @option opts [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 Filter by status.
+    # @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 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<Array<Calendly::OrganizationInvitation>, Hash>]
     #  - [Array<Calendly::OrganizationInvitation>] organizations
     #  - [Hash] next_params the parameters to get next data. if thre is no next it returns nil.
     # @raise [Calendly::Error] if the uuid arg is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.0.6
-    def invitations(uuid, opts = {})
+    def invitations(uuid, options: nil)
       check_not_empty uuid, 'uuid'
 
       opts_keys = %i[count email page_token sort status]
-      params = merge_options opts, opts_keys
+      params = merge_options options, opts_keys
 
       body = request :get, "organizations/#{uuid}/invitations", params: params
       items = body[:collection] || []
@@ -436,22 +463,22 @@ module Calendly
     # Get List of organization scope Webhooks.
     #
     # @param [String] org_uri the specified organization (organization's uri).
-    # @param [Hash] opts the optional request parameters.
-    # @option opts [Integer] :count Number of rows to return.
-    # @option opts [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.
+    # @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<Array<Calendly::WebhookSubscription>, Hash>]
     #  - [Array<Calendly::WebhookSubscription>] webhooks
     #  - [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.1.3
-    def webhooks(org_uri, opts = {})
+    def webhooks(org_uri, options: nil)
       check_not_empty org_uri, 'org_uri'
 
       opts_keys = %i[count page_token sort]
       params = {organization: org_uri, scope: 'organization'}
-      params = merge_options opts, opts_keys, params
+      params = merge_options options, opts_keys, params
       body = request :get, 'webhook_subscriptions', params: params
       items = body[:collection] || []
       evs = items.map { |item| WebhookSubscription.new item, self }
@@ -463,10 +490,10 @@ module Calendly
     #
     # @param [String] org_uri the specified organization (organization's uri).
     # @param [String] user_uri the specified user (user's uri).
-    # @param [Hash] opts the optional request parameters.
-    # @option opts [Integer] :count Number of rows to return.
-    # @option opts [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.
+    # @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<Array<Calendly::WebhookSubscription>, Hash>]
     #  - [Array<Calendly::WebhookSubscription>] webhooks
     #  - [Hash] next_params the parameters to get next data. if thre is no next it returns nil.
@@ -474,13 +501,13 @@ module Calendly
     # @raise [Calendly::Error] if the user_uri arg is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.1.3
-    def user_scope_webhooks(org_uri, user_uri, opts = {})
+    def user_scope_webhooks(org_uri, user_uri, options: nil)
       check_not_empty org_uri, 'org_uri'
       check_not_empty user_uri, 'user_uri'
 
       opts_keys = %i[count page_token sort]
       params = {organization: org_uri, user: user_uri, scope: 'user'}
-      params = merge_options opts, opts_keys, params
+      params = merge_options options, opts_keys, params
       body = request :get, 'webhook_subscriptions', params: params
       items = body[:collection] || []
       evs = items.map { |item| WebhookSubscription.new item, self }
@@ -493,26 +520,29 @@ module Calendly
     # @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 [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.
+    # @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.
     # @return [Calendly::WebhookSubscription]
     # @raise [Calendly::Error] if the url arg is empty.
     # @raise [Calendly::Error] if the events arg is empty.
     # @raise [Calendly::Error] if the org_uri arg is empty.
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.1.3
-    def create_webhook(url, events, org_uri, user_uri = nil)
+    def create_webhook(url, events, org_uri, user_uri: nil, signing_key: nil) # rubocop:disable Metrics/ParameterLists
       check_not_empty url, 'url'
       check_not_empty events, 'events'
       check_not_empty org_uri, 'org_uri'
 
       params = {url: url, events: events, organization: org_uri}
+      params[:signing_key] = signing_key if signing_key
+
       if user_uri
         params[:scope] = 'user'
         params[:user] = user_uri
       else
         params[:scope] = 'organization'
       end
-      body = request(:post, 'webhook_subscriptions', body: params)
+      body = request :post, 'webhook_subscriptions', body: params
       WebhookSubscription.new body[:resource], self
     end
 
@@ -530,12 +560,43 @@ module Calendly
       true
     end
 
+    #
+    # Create a scheduling link.
+    #
+    # @param [String] uri A link to the resource that owns this scheduling Link.
+    # @param [String] max_event_count The max number of events that can be scheduled using this scheduling link.
+    # @param [String] owner_type Resource type.
+    # @return [Hash]
+    # e.g.
+    # {
+    #   booking_url: "https://calendly.com/s/FOO-BAR-SLUG",
+    #   owner: "https://api.calendly.com/event_types/GBGBDCAADAEDCRZ2",
+    #   owner_type: "EventType"
+    # }
+    # @raise [Calendly::Error] if the uri arg is empty.
+    # @raise [Calendly::Error] if the max_event_count arg is empty.
+    # @raise [Calendly::Error] if the owner_type arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.5.2
+    def create_schedule_link(uri, max_event_count: 1, owner_type: 'EventType')
+      check_not_empty uri, 'uri'
+      check_not_empty max_event_count, 'max_event_count'
+      check_not_empty owner_type, 'owner_type'
+      params = {
+        max_event_count: max_event_count,
+        owner: uri,
+        owner_type: owner_type
+      }
+      body = request :post, 'scheduling_links', body: params
+      body[:resource]
+    end
+
   private
 
     def request(method, path, params: nil, body: nil)
       debug_log "Request #{method.to_s.upcase} #{API_HOST}/#{path} params:#{params}, body:#{body}"
-      res = access_token.request(method, path, params: params, body: body)
-      debug_log "Response status:#{res.status}, body:#{res.body}"
+      res = access_token.request method, path, params: params, body: body
+      debug_log "Response status:#{res.status}, body:#{res.body.dup&.force_encoding(Encoding::UTF_8)}"
       parse_as_json res
     rescue OAuth2::Error => e
       res = e.response.response