fern_gusto 0.0.6.pre.alpha6

data/lib/fern_gusto/companies/client.rb

@@ -0,0 +1,1104 @@
+# frozen_string_literal: true
+require_relative "../../requests"
+require_relative "attachments/client"
+require_relative "federal_tax_details/client"
+require_relative "industry_selection/client"
+require_relative "signatories/client"
+require_relative "locations/client"
+require_relative "bank_accounts/client"
+require_relative "external_payrolls/client"
+require_relative "payment_configs/client"
+require_relative "pay_schedules/client"
+require_relative "employees/client"
+require_relative "departments/client"
+require_relative "forms/client"
+require_relative "benefits/client"
+require_relative "tax_requirements/client"
+require_relative "types/companies_create_request_user"
+require_relative "types/companies_create_request_company"
+require_relative "types/companies_create_response"
+require_relative "types/company"
+require_relative "types/companies_migrate_to_embedded_payroll_response"
+require_relative "types/companies_accept_terms_response"
+require_relative "types/companies_retrieve_terms_response"
+require_relative "../admins/types/admin"
+require "json"
+require_relative "types/company_onboarding_status"
+require_relative "types/companies_get_custom_fields_response"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require_relative "../../requests"
+
+module Gusto
+  class CompaniesClient
+  # @return [Gusto::RequestClient] 
+    attr_reader :request_client
+  # @return [Gusto::Companies::AttachmentsClient] 
+    attr_reader :attachments
+  # @return [Gusto::Companies::FederalTaxDetailsClient] 
+    attr_reader :federal_tax_details
+  # @return [Gusto::Companies::IndustrySelectionClient] 
+    attr_reader :industry_selection
+  # @return [Gusto::Companies::SignatoriesClient] 
+    attr_reader :signatories
+  # @return [Gusto::Companies::LocationsClient] 
+    attr_reader :locations
+  # @return [Gusto::Companies::BankAccountsClient] 
+    attr_reader :bank_accounts
+  # @return [Gusto::Companies::ExternalPayrollsClient] 
+    attr_reader :external_payrolls
+  # @return [Gusto::Companies::PaymentConfigsClient] 
+    attr_reader :payment_configs
+  # @return [Gusto::Companies::PaySchedulesClient] 
+    attr_reader :pay_schedules
+  # @return [Gusto::Companies::EmployeesClient] 
+    attr_reader :employees
+  # @return [Gusto::Companies::DepartmentsClient] 
+    attr_reader :departments
+  # @return [Gusto::Companies::FormsClient] 
+    attr_reader :forms
+  # @return [Gusto::Companies::BenefitsClient] 
+    attr_reader :benefits
+  # @return [Gusto::Companies::TaxRequirementsClient] 
+    attr_reader :tax_requirements
+
+
+    # @param request_client [Gusto::RequestClient] 
+    # @return [Gusto::CompaniesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+      @attachments = Gusto::Companies::AttachmentsClient.new(request_client: request_client)
+      @federal_tax_details = Gusto::Companies::FederalTaxDetailsClient.new(request_client: request_client)
+      @industry_selection = Gusto::Companies::IndustrySelectionClient.new(request_client: request_client)
+      @signatories = Gusto::Companies::SignatoriesClient.new(request_client: request_client)
+      @locations = Gusto::Companies::LocationsClient.new(request_client: request_client)
+      @bank_accounts = Gusto::Companies::BankAccountsClient.new(request_client: request_client)
+      @external_payrolls = Gusto::Companies::ExternalPayrollsClient.new(request_client: request_client)
+      @payment_configs = Gusto::Companies::PaymentConfigsClient.new(request_client: request_client)
+      @pay_schedules = Gusto::Companies::PaySchedulesClient.new(request_client: request_client)
+      @employees = Gusto::Companies::EmployeesClient.new(request_client: request_client)
+      @departments = Gusto::Companies::DepartmentsClient.new(request_client: request_client)
+      @forms = Gusto::Companies::FormsClient.new(request_client: request_client)
+      @benefits = Gusto::Companies::BenefitsClient.new(request_client: request_client)
+      @tax_requirements = Gusto::Companies::TaxRequirementsClient.new(request_client: request_client)
+    end
+# Create a partner managed company. When you successfully call the API, it does
+#  the following:
+#  - Creates a new company in Gusto
+#  - Creates a new user using the provided email if the user does not already
+#  exist.
+#  - Makes the user the primary payroll administrator of the new company.
+#  In response, you will receive oauth access tokens for the created company.
+#  IMPORTANT: the returned access and refresh tokens are reserved for this company
+#  only. They cannot be used to access other companies AND previously granted
+#  tokens cannot be used to access this company.
+#  > 📘 System Access Authentication
+#  >
+#  > this endpoint uses the [Bearer Auth scheme with the system-level access token
+#  in the HTTP Authorization
+#  header](https://docs.gusto.com/embedded-payroll/docs/system-access)
+    #
+    # @param user [Hash] Information for the user who will be the primary payroll administrator for the
+#  new company.Request of type Gusto::Companies::CompaniesCreateRequestUser, as a Hash
+    #   * :first_name (String) 
+    #   * :last_name (String) 
+    #   * :email (String) 
+    #   * :phone (String) 
+    # @param company [Hash] Request of type Gusto::Companies::CompaniesCreateRequestCompany, as a Hash
+    #   * :name (String) 
+    #   * :trade_name (String) 
+    #   * :ein (String) 
+    #   * :contractor_only (Boolean) 
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompaniesCreateResponse]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.create(user: { first_name: "Frank", last_name: "Ocean", email: "frank@example.com", phone: "2345558899" }, company: { name: "Frank's Ocean, LLC", trade_name: "Frank’s Ocean", ein: "123456789", contractor_only: false })
+    def create(user:, company:, request_options: nil)
+      response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), user: user, company: company }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/partner_managed_companies"
+end
+      Gusto::Companies::CompaniesCreateResponse.from_json(json_object: response.body)
+    end
+# Get a company.
+#  The employees:read scope is required to return home_address and non-work
+#  locations.
+#  The company_admin:read scope is required to return primary_payroll_admin.
+#  The signatories:read scope is required to return primary_signatory.
+#  scope: `companies:read`
+    #
+    # @param company_id [String] The UUID of the company
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::Company]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.get(company_id: "company_id")
+    def get(company_id:, request_options: nil)
+      response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}"
+end
+      Gusto::Companies::Company.from_json(json_object: response.body)
+    end
+# Update a company.
+#  scope: `companies:write`
+    #
+    # @param company_id [String] The UUID of the company
+    # @param contractor_only [Boolean] Whether the company only supports contractors. Must be updated in order for the
+#  company to start supporting W-2 employees. Can only be updated from true to
+#  false. Note that updating this value will require additional onboarding steps to
+#  be completed in order for the company to support W-2 employees.
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::Company]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.update(company_id: "company_id", contractor_only: false)
+    def update(company_id:, contractor_only:, request_options: nil)
+      response = @request_client.conn.put do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), contractor_only: contractor_only }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}"
+end
+      Gusto::Companies::Company.from_json(json_object: response.body)
+    end
+# Migrate an existing Gusto customer to your embedded payroll product.
+#  To use this endpoint, the customer will need to connect their Gusto account to
+#  your application using
+#  [OAuth2](https://docs.gusto.com/embedded-payroll/docs/oauth2) then view and
+#  [accept the Embedded Payroll Terms of
+#  /reference/post-partner-managed-companies-company_uuid-accept_terms_of_service).
+#  scope: `partner_managed_companies:write`
+    #
+    # @param company_uuid [String] The UUID of the company
+    # @param email [String] Email of the company signatory who is authorized to accept our [Terms of
+#  Service](https://flows.gusto.com/terms) and migration decision. You can retrieve
+#  the signatory email from the `GET /v/1/companies/{company_id}/signatories`
+#  endpoint.
+    # @param ip_address [String] The IP address of the signatory who viewed and accepted the Terms of Service.
+    # @param external_user_id [String] The signatory's user ID on your platform.
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompaniesMigrateToEmbeddedPayrollResponse]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.migrate_to_embedded_payroll(
+#    company_uuid: "company_uuid",
+#    email: "email",
+#    ip_address: "ip_address",
+#    external_user_id: "external_user_id"
+#  )
+    def migrate_to_embedded_payroll(company_uuid:, email:, ip_address:, external_user_id:, request_options: nil)
+      response = @request_client.conn.put do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), email: email, ip_address: ip_address, external_user_id: external_user_id }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/partner_managed_companies/#{company_uuid}/migrate"
+end
+      Gusto::Companies::CompaniesMigrateToEmbeddedPayrollResponse.from_json(json_object: response.body)
+    end
+# Accept the Gusto Embedded Payroll's [Terms of
+#  Service](https://flows.gusto.com/terms).
+#  The user must have a role in the company in order to accept the Terms of
+#  Service.
+#  scope: `terms_of_services:write`
+    #
+    # @param company_uuid [String] The UUID of the company
+    # @param email [String] The user's email address on Gusto. You can retrieve the user's email via
+#  company's `/admins`, `/employees`, `/signatories`, and `/contractors` endpoints.
+    # @param ip_address [String] The IP address of the user who viewed and accepted the Terms of Service.
+    # @param external_user_id [String] The user ID on your platform.
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompaniesAcceptTermsResponse]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.accept_terms(
+#    company_uuid: "company_uuid",
+#    email: "email",
+#    ip_address: "ip_address",
+#    external_user_id: "external_user_id"
+#  )
+    def accept_terms(company_uuid:, email:, ip_address:, external_user_id:, request_options: nil)
+      response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), email: email, ip_address: ip_address, external_user_id: external_user_id }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/partner_managed_companies/#{company_uuid}/accept_terms_of_service"
+end
+      Gusto::Companies::CompaniesAcceptTermsResponse.from_json(json_object: response.body)
+    end
+# Retrieve the user acceptance status of the Gusto Embedded Payroll's [Terms of
+#  Service](https://flows.gusto.com/terms).
+#  scope: `terms_of_services:read`
+    #
+    # @param company_uuid [String] The UUID of the company
+    # @param email [String] The user's email address on Gusto. You can retrieve the user's email via
+#  company's `/admins`, `/employees`, `/signatories`, and `/contractors` endpoints.
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompaniesRetrieveTermsResponse]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.retrieve_terms(company_uuid: "company_uuid", email: "email")
+    def retrieve_terms(company_uuid:, email:, request_options: nil)
+      response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), email: email }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/partner_managed_companies/#{company_uuid}/retrieve_terms_of_service"
+end
+      Gusto::Companies::CompaniesRetrieveTermsResponse.from_json(json_object: response.body)
+    end
+# Returns a list of all the admins at a company
+#  scope: `company_admin:read`
+    #
+    # @param company_id [String] The UUID of the company
+    # @param page [Float] The page that is requested. When unspecified, will load all objects unless
+#  endpoint forces pagination.
+    # @param per [Float] Number of objects per page. For majority of endpoints will default to 25
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Array<Gusto::Admins::Admin>]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.get_all_admins(company_id: "company_id")
+    def get_all_admins(company_id:, page: nil, per: nil, request_options: nil)
+      response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "page": page, "per": per }.compact
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}/admins"
+end
+      parsed_json = JSON.parse(response.body)
+      parsed_json&.map do | item |
+        item = item.to_json
+        Gusto::Admins::Admin.from_json(json_object: item)
+      end
+    end
+# Creates a new admin for a company.
+#  If the email matches an existing user, this will create an admin account for the
+#  current user. Otherwise, this will create a new user.
+#  scope: `company_admin:write`
+    #
+    # @param company_id [String] The UUID of the company
+    # @param first_name [String] The first name of the admin.
+    # @param last_name [String] The last name of the admin.
+    # @param email [String] The email of the admin for Gusto's system. If the email matches an existing
+#  user, this will create an admin account for them.
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Admins::Admin]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.create_admin(
+#    company_id: "company_id",
+#    first_name: "John",
+#    last_name: "Smith",
+#    email: "jsmith99@gmail.com"
+#  )
+    def create_admin(company_id:, first_name:, last_name:, email:, request_options: nil)
+      response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), first_name: first_name, last_name: last_name, email: email }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}/admins"
+end
+      Gusto::Admins::Admin.from_json(json_object: response.body)
+    end
+# Get company's onboarding status.
+#  The data returned helps inform the required onboarding steps and respective
+#  completion status.
+#  scope: `company_onboarding_status:read`
+    #
+    # @param company_uuid [String] The UUID of the company
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompanyOnboardingStatus]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.get_onboarding_status(company_uuid: "company_uuid")
+    def get_onboarding_status(company_uuid:, request_options: nil)
+      response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_uuid}/onboarding_status"
+end
+      Gusto::Companies::CompanyOnboardingStatus.from_json(json_object: response.body)
+    end
+# Finalize a given company's onboarding process.
+#  ### Approve a company in demo
+#  After a company is finished onboarding, Gusto requires an additional step to
+#  review and approve that company. The company onboarding status is
+#  `"onboarding_completed": false`, until the API call is made to finish company
+#  onboarding.
+#  In production environments, this step is required for risk-analysis purposes.
+#  We provide the endpoint `PUT '/v1/companies/{company_uuid}/approve'` to
+#  facilitate company approvals in the demo environment.
+#  ```shell
+#  PUT '/v1/companies/89771af8-b964-472e-8064-554dfbcb56d9/approve'
+#  # Response: Company object, with company_status: 'Approved'
+#  ```
+#  scope: `companies:write`
+    #
+    # @param company_uuid [String] The UUID of the company
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompanyOnboardingStatus]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.finish_onboarding(company_uuid: "company_uuid")
+    def finish_onboarding(company_uuid:, request_options: nil)
+      response = @request_client.conn.put do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_uuid}/finish_onboarding"
+end
+      Gusto::Companies::CompanyOnboardingStatus.from_json(json_object: response.body)
+    end
+# Returns a list of the custom fields of the company. Useful when you need to know
+#  the schema of custom fields for an entire company
+#  scope: `companies:read`
+    #
+    # @param company_id [String] The UUID of the company
+    # @param page [Float] The page that is requested. When unspecified, will load all objects unless
+#  endpoint forces pagination.
+    # @param per [Float] Number of objects per page. For majority of endpoints will default to 25
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompaniesGetCustomFieldsResponse]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.get_custom_fields(company_id: "company_id")
+    def get_custom_fields(company_id:, page: nil, per: nil, request_options: nil)
+      response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "page": page, "per": per }.compact
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}/custom_fields"
+end
+      Gusto::Companies::CompaniesGetCustomFieldsResponse.from_json(json_object: response.body)
+    end
+  end
+  class AsyncCompaniesClient
+  # @return [Gusto::AsyncRequestClient] 
+    attr_reader :request_client
+  # @return [Gusto::Companies::AttachmentsClient] 
+    attr_reader :attachments
+  # @return [Gusto::Companies::FederalTaxDetailsClient] 
+    attr_reader :federal_tax_details
+  # @return [Gusto::Companies::IndustrySelectionClient] 
+    attr_reader :industry_selection
+  # @return [Gusto::Companies::SignatoriesClient] 
+    attr_reader :signatories
+  # @return [Gusto::Companies::LocationsClient] 
+    attr_reader :locations
+  # @return [Gusto::Companies::BankAccountsClient] 
+    attr_reader :bank_accounts
+  # @return [Gusto::Companies::ExternalPayrollsClient] 
+    attr_reader :external_payrolls
+  # @return [Gusto::Companies::PaymentConfigsClient] 
+    attr_reader :payment_configs
+  # @return [Gusto::Companies::PaySchedulesClient] 
+    attr_reader :pay_schedules
+  # @return [Gusto::Companies::EmployeesClient] 
+    attr_reader :employees
+  # @return [Gusto::Companies::DepartmentsClient] 
+    attr_reader :departments
+  # @return [Gusto::Companies::FormsClient] 
+    attr_reader :forms
+  # @return [Gusto::Companies::BenefitsClient] 
+    attr_reader :benefits
+  # @return [Gusto::Companies::TaxRequirementsClient] 
+    attr_reader :tax_requirements
+
+
+    # @param request_client [Gusto::RequestClient] 
+    # @return [Gusto::AsyncCompaniesClient]
+    def initialize(request_client:)
+      @request_client = request_client
+      @attachments = Gusto::Companies::AsyncAttachmentsClient.new(request_client: request_client)
+      @federal_tax_details = Gusto::Companies::AsyncFederalTaxDetailsClient.new(request_client: request_client)
+      @industry_selection = Gusto::Companies::AsyncIndustrySelectionClient.new(request_client: request_client)
+      @signatories = Gusto::Companies::AsyncSignatoriesClient.new(request_client: request_client)
+      @locations = Gusto::Companies::AsyncLocationsClient.new(request_client: request_client)
+      @bank_accounts = Gusto::Companies::AsyncBankAccountsClient.new(request_client: request_client)
+      @external_payrolls = Gusto::Companies::AsyncExternalPayrollsClient.new(request_client: request_client)
+      @payment_configs = Gusto::Companies::AsyncPaymentConfigsClient.new(request_client: request_client)
+      @pay_schedules = Gusto::Companies::AsyncPaySchedulesClient.new(request_client: request_client)
+      @employees = Gusto::Companies::AsyncEmployeesClient.new(request_client: request_client)
+      @departments = Gusto::Companies::AsyncDepartmentsClient.new(request_client: request_client)
+      @forms = Gusto::Companies::AsyncFormsClient.new(request_client: request_client)
+      @benefits = Gusto::Companies::AsyncBenefitsClient.new(request_client: request_client)
+      @tax_requirements = Gusto::Companies::AsyncTaxRequirementsClient.new(request_client: request_client)
+    end
+# Create a partner managed company. When you successfully call the API, it does
+#  the following:
+#  - Creates a new company in Gusto
+#  - Creates a new user using the provided email if the user does not already
+#  exist.
+#  - Makes the user the primary payroll administrator of the new company.
+#  In response, you will receive oauth access tokens for the created company.
+#  IMPORTANT: the returned access and refresh tokens are reserved for this company
+#  only. They cannot be used to access other companies AND previously granted
+#  tokens cannot be used to access this company.
+#  > 📘 System Access Authentication
+#  >
+#  > this endpoint uses the [Bearer Auth scheme with the system-level access token
+#  in the HTTP Authorization
+#  header](https://docs.gusto.com/embedded-payroll/docs/system-access)
+    #
+    # @param user [Hash] Information for the user who will be the primary payroll administrator for the
+#  new company.Request of type Gusto::Companies::CompaniesCreateRequestUser, as a Hash
+    #   * :first_name (String) 
+    #   * :last_name (String) 
+    #   * :email (String) 
+    #   * :phone (String) 
+    # @param company [Hash] Request of type Gusto::Companies::CompaniesCreateRequestCompany, as a Hash
+    #   * :name (String) 
+    #   * :trade_name (String) 
+    #   * :ein (String) 
+    #   * :contractor_only (Boolean) 
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompaniesCreateResponse]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.create(user: { first_name: "Frank", last_name: "Ocean", email: "frank@example.com", phone: "2345558899" }, company: { name: "Frank's Ocean, LLC", trade_name: "Frank’s Ocean", ein: "123456789", contractor_only: false })
+    def create(user:, company:, request_options: nil)
+      Async do
+        response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), user: user, company: company }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/partner_managed_companies"
+end
+        Gusto::Companies::CompaniesCreateResponse.from_json(json_object: response.body)
+      end
+    end
+# Get a company.
+#  The employees:read scope is required to return home_address and non-work
+#  locations.
+#  The company_admin:read scope is required to return primary_payroll_admin.
+#  The signatories:read scope is required to return primary_signatory.
+#  scope: `companies:read`
+    #
+    # @param company_id [String] The UUID of the company
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::Company]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.get(company_id: "company_id")
+    def get(company_id:, request_options: nil)
+      Async do
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}"
+end
+        Gusto::Companies::Company.from_json(json_object: response.body)
+      end
+    end
+# Update a company.
+#  scope: `companies:write`
+    #
+    # @param company_id [String] The UUID of the company
+    # @param contractor_only [Boolean] Whether the company only supports contractors. Must be updated in order for the
+#  company to start supporting W-2 employees. Can only be updated from true to
+#  false. Note that updating this value will require additional onboarding steps to
+#  be completed in order for the company to support W-2 employees.
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::Company]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.update(company_id: "company_id", contractor_only: false)
+    def update(company_id:, contractor_only:, request_options: nil)
+      Async do
+        response = @request_client.conn.put do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), contractor_only: contractor_only }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}"
+end
+        Gusto::Companies::Company.from_json(json_object: response.body)
+      end
+    end
+# Migrate an existing Gusto customer to your embedded payroll product.
+#  To use this endpoint, the customer will need to connect their Gusto account to
+#  your application using
+#  [OAuth2](https://docs.gusto.com/embedded-payroll/docs/oauth2) then view and
+#  [accept the Embedded Payroll Terms of
+#  /reference/post-partner-managed-companies-company_uuid-accept_terms_of_service).
+#  scope: `partner_managed_companies:write`
+    #
+    # @param company_uuid [String] The UUID of the company
+    # @param email [String] Email of the company signatory who is authorized to accept our [Terms of
+#  Service](https://flows.gusto.com/terms) and migration decision. You can retrieve
+#  the signatory email from the `GET /v/1/companies/{company_id}/signatories`
+#  endpoint.
+    # @param ip_address [String] The IP address of the signatory who viewed and accepted the Terms of Service.
+    # @param external_user_id [String] The signatory's user ID on your platform.
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompaniesMigrateToEmbeddedPayrollResponse]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.migrate_to_embedded_payroll(
+#    company_uuid: "company_uuid",
+#    email: "email",
+#    ip_address: "ip_address",
+#    external_user_id: "external_user_id"
+#  )
+    def migrate_to_embedded_payroll(company_uuid:, email:, ip_address:, external_user_id:, request_options: nil)
+      Async do
+        response = @request_client.conn.put do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), email: email, ip_address: ip_address, external_user_id: external_user_id }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/partner_managed_companies/#{company_uuid}/migrate"
+end
+        Gusto::Companies::CompaniesMigrateToEmbeddedPayrollResponse.from_json(json_object: response.body)
+      end
+    end
+# Accept the Gusto Embedded Payroll's [Terms of
+#  Service](https://flows.gusto.com/terms).
+#  The user must have a role in the company in order to accept the Terms of
+#  Service.
+#  scope: `terms_of_services:write`
+    #
+    # @param company_uuid [String] The UUID of the company
+    # @param email [String] The user's email address on Gusto. You can retrieve the user's email via
+#  company's `/admins`, `/employees`, `/signatories`, and `/contractors` endpoints.
+    # @param ip_address [String] The IP address of the user who viewed and accepted the Terms of Service.
+    # @param external_user_id [String] The user ID on your platform.
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompaniesAcceptTermsResponse]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.accept_terms(
+#    company_uuid: "company_uuid",
+#    email: "email",
+#    ip_address: "ip_address",
+#    external_user_id: "external_user_id"
+#  )
+    def accept_terms(company_uuid:, email:, ip_address:, external_user_id:, request_options: nil)
+      Async do
+        response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), email: email, ip_address: ip_address, external_user_id: external_user_id }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/partner_managed_companies/#{company_uuid}/accept_terms_of_service"
+end
+        Gusto::Companies::CompaniesAcceptTermsResponse.from_json(json_object: response.body)
+      end
+    end
+# Retrieve the user acceptance status of the Gusto Embedded Payroll's [Terms of
+#  Service](https://flows.gusto.com/terms).
+#  scope: `terms_of_services:read`
+    #
+    # @param company_uuid [String] The UUID of the company
+    # @param email [String] The user's email address on Gusto. You can retrieve the user's email via
+#  company's `/admins`, `/employees`, `/signatories`, and `/contractors` endpoints.
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompaniesRetrieveTermsResponse]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.retrieve_terms(company_uuid: "company_uuid", email: "email")
+    def retrieve_terms(company_uuid:, email:, request_options: nil)
+      Async do
+        response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), email: email }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/partner_managed_companies/#{company_uuid}/retrieve_terms_of_service"
+end
+        Gusto::Companies::CompaniesRetrieveTermsResponse.from_json(json_object: response.body)
+      end
+    end
+# Returns a list of all the admins at a company
+#  scope: `company_admin:read`
+    #
+    # @param company_id [String] The UUID of the company
+    # @param page [Float] The page that is requested. When unspecified, will load all objects unless
+#  endpoint forces pagination.
+    # @param per [Float] Number of objects per page. For majority of endpoints will default to 25
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Array<Gusto::Admins::Admin>]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.get_all_admins(company_id: "company_id")
+    def get_all_admins(company_id:, page: nil, per: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "page": page, "per": per }.compact
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}/admins"
+end
+        parsed_json = JSON.parse(response.body)
+        parsed_json&.map do | item |
+          item = item.to_json
+          Gusto::Admins::Admin.from_json(json_object: item)
+        end
+      end
+    end
+# Creates a new admin for a company.
+#  If the email matches an existing user, this will create an admin account for the
+#  current user. Otherwise, this will create a new user.
+#  scope: `company_admin:write`
+    #
+    # @param company_id [String] The UUID of the company
+    # @param first_name [String] The first name of the admin.
+    # @param last_name [String] The last name of the admin.
+    # @param email [String] The email of the admin for Gusto's system. If the email matches an existing
+#  user, this will create an admin account for them.
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Admins::Admin]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.create_admin(
+#    company_id: "company_id",
+#    first_name: "John",
+#    last_name: "Smith",
+#    email: "jsmith99@gmail.com"
+#  )
+    def create_admin(company_id:, first_name:, last_name:, email:, request_options: nil)
+      Async do
+        response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), first_name: first_name, last_name: last_name, email: email }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}/admins"
+end
+        Gusto::Admins::Admin.from_json(json_object: response.body)
+      end
+    end
+# Get company's onboarding status.
+#  The data returned helps inform the required onboarding steps and respective
+#  completion status.
+#  scope: `company_onboarding_status:read`
+    #
+    # @param company_uuid [String] The UUID of the company
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompanyOnboardingStatus]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.get_onboarding_status(company_uuid: "company_uuid")
+    def get_onboarding_status(company_uuid:, request_options: nil)
+      Async do
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_uuid}/onboarding_status"
+end
+        Gusto::Companies::CompanyOnboardingStatus.from_json(json_object: response.body)
+      end
+    end
+# Finalize a given company's onboarding process.
+#  ### Approve a company in demo
+#  After a company is finished onboarding, Gusto requires an additional step to
+#  review and approve that company. The company onboarding status is
+#  `"onboarding_completed": false`, until the API call is made to finish company
+#  onboarding.
+#  In production environments, this step is required for risk-analysis purposes.
+#  We provide the endpoint `PUT '/v1/companies/{company_uuid}/approve'` to
+#  facilitate company approvals in the demo environment.
+#  ```shell
+#  PUT '/v1/companies/89771af8-b964-472e-8064-554dfbcb56d9/approve'
+#  # Response: Company object, with company_status: 'Approved'
+#  ```
+#  scope: `companies:write`
+    #
+    # @param company_uuid [String] The UUID of the company
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompanyOnboardingStatus]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.finish_onboarding(company_uuid: "company_uuid")
+    def finish_onboarding(company_uuid:, request_options: nil)
+      Async do
+        response = @request_client.conn.put do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_uuid}/finish_onboarding"
+end
+        Gusto::Companies::CompanyOnboardingStatus.from_json(json_object: response.body)
+      end
+    end
+# Returns a list of the custom fields of the company. Useful when you need to know
+#  the schema of custom fields for an entire company
+#  scope: `companies:read`
+    #
+    # @param company_id [String] The UUID of the company
+    # @param page [Float] The page that is requested. When unspecified, will load all objects unless
+#  endpoint forces pagination.
+    # @param per [Float] Number of objects per page. For majority of endpoints will default to 25
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [Gusto::Companies::CompaniesGetCustomFieldsResponse]
+    # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.companies.get_custom_fields(company_id: "company_id")
+    def get_custom_fields(company_id:, page: nil, per: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  req.params = { **(request_options&.additional_query_parameters || {}), "page": page, "per": per }.compact
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/companies/#{company_id}/custom_fields"
+end
+        Gusto::Companies::CompaniesGetCustomFieldsResponse.from_json(json_object: response.body)
+      end
+    end
+  end
+end