Skip to Content

Connect SmartHR to Your AI Agent

Prepare new hires, maintain employee details, and keep departments, job titles, and employment types up to date.

54 toolsAPI key

20,000 free app calls every month(paid services billed separately)

Try a SmartHR Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillSmartHR

Prepare an Employee Review

Find relevant employees and collect the fields needed for a staffing review.

/oo SmartHR: List active SmartHR employees in [department ID], retrieve all pages, and summarize their employee numbers and names.

Understand Your Organization

Review companies, workplaces, employment types, and custom employee fields.

/oo SmartHR: Review our SmartHR companies, business establishments, departments, and employment types. Explain the organization and which custom fields are available.

Maintain Department Records

Create departments, adjust their details, or discontinue departments that have closed.

/oo SmartHR: Create the SmartHR department [name] under [parent department ID], using code [code]. Retrieve the resulting department for verification.

Prepare and Invite a New Employee

Create an employee record, attach onboarding documents, and send an invitation using the chosen form.

/oo SmartHR: Create a SmartHR employee using [employee details] and the resume at [file link]. Find our invitation forms and administrator users, then use [chosen form] and [inviting administrator] to invite the employee.

Maintain Employee Information

Apply employee updates while preserving other details, and handle explicit record removal requests.

/oo SmartHR: Update SmartHR employee [employee ID] with [employment type], [department IDs], and [job title names]. Keep other details unchanged and retrieve the updated record.

Maintain Organization Reference Data

Keep job titles, grades, job categories, recruitment types, and employment types aligned with your organization.

/oo SmartHR: List our SmartHR job titles and grades. Create job title [name] with rank [rank] and code [code], then retrieve it to verify the result.

Start Working with SmartHR

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect SmartHR

    Connect a SmartHR administrator-issued access token and your company subdomain.

    Connect SmartHR→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • Company information read permission for connection validation.
  • Resource and employee-field permissions for the operations you intend to use.
  • The production environment is selected by default; official sandbox tenants are also supported.
  • Employee fields depend on your token permissions.
  • Employee attachments can be supplied as accessible file links; employee writes and invitations require the corresponding token permissions.

SmartHR Tools

Search, create, update, invite, and delete employees; attach documents from file links; maintain departments, employment types, job titles, grades, job categories, and recruitment types. Discover invitation forms, users, payment periods, bank account settings, and custom fields.

Employee Lifecycle

Search, create, update, invite, and delete employees, or clear their department assignments.

Organization and Field Reference

Read company, workplace, department, employment type, and custom field information.

Department Management

Create, partially update, fully replace, and discontinue departments.

Organization Master Data

Read and maintain job titles, grades, job categories, recruitment types, and employment types.

Onboarding Reference

Find users, invitation forms, payment periods, and bank account settings for employee onboarding.

54 tools

Create Employment Type

Create a SmartHR employment type. System preset and scheduled-change restrictions are enforced by SmartHR.

smarthr.create_employment_type

Update Employment Type

Partially update a SmartHR employment type, preserving unspecified attributes. System preset and scheduled-change restrictions are enforced by SmartHR.

smarthr.update_employment_type

Replace Employment Type

Update a SmartHR employment type using the full-update endpoint; use partial update to preserve unspecified attributes. System preset and scheduled-change restrictions are enforced by SmartHR.

smarthr.replace_employment_type

Delete Employment Type

Delete a SmartHR employment type. System preset and scheduled-change restrictions are enforced by SmartHR.

smarthr.delete_employment_type

List Job Titles

List SmartHR job title records with pagination.

smarthr.list_job_titles

Get Job Title

Get a SmartHR job title by ID.

smarthr.get_job_title

Create Job Title

Create a SmartHR job title.

smarthr.create_job_title

Update Job Title

Partially update a SmartHR job title, preserving unspecified attributes.

smarthr.update_job_title

Replace Job Title

Update a SmartHR job title using the full-update endpoint; use partial update to preserve unspecified attributes.

smarthr.replace_job_title

Delete Job Title

Delete a SmartHR job title.

smarthr.delete_job_title

List Grades

List SmartHR grade records with pagination.

smarthr.list_grades

Get Grade

Get a SmartHR grade by ID.

smarthr.get_grade

Create Grade

Create a SmartHR grade.

smarthr.create_grade

Update Grade

Partially update a SmartHR grade, preserving unspecified attributes.

smarthr.update_grade

Replace Grade

Update a SmartHR grade using the full-update endpoint; use partial update to preserve unspecified attributes.

smarthr.replace_grade

Delete Grade

Delete a SmartHR grade.

smarthr.delete_grade

List Job Categories

List SmartHR job category records with pagination.

smarthr.list_job_categories

Get Job Category

Get a SmartHR job category by ID.

smarthr.get_job_category

Create Job Category

Create a SmartHR job category.

smarthr.create_job_category

Update Job Category

Partially update a SmartHR job category, preserving unspecified attributes.

smarthr.update_job_category

Replace Job Category

Update a SmartHR job category using the full-update endpoint; use partial update to preserve unspecified attributes.

smarthr.replace_job_category

Delete Job Category

Delete a SmartHR job category.

smarthr.delete_job_category

List Recruitment Types

List SmartHR recruitment type records with pagination.

smarthr.list_recruitment_types

Get Recruitment Type

Get a SmartHR recruitment type by ID.

smarthr.get_recruitment_type

Create Recruitment Type

Create a SmartHR recruitment type.

smarthr.create_recruitment_type

Update Recruitment Type

Partially update a SmartHR recruitment type, preserving unspecified attributes.

smarthr.update_recruitment_type

Replace Recruitment Type

Update a SmartHR recruitment type using the full-update endpoint; use partial update to preserve unspecified attributes.

smarthr.replace_recruitment_type

Delete Recruitment Type

Delete a SmartHR recruitment type.

smarthr.delete_recruitment_type

List Users

List SmartHR user records with pagination.

smarthr.list_users

Get User

Get a SmartHR user by ID.

smarthr.get_user

List Employee Input Forms

List SmartHR employee information collection form records with pagination.

smarthr.list_employee_input_forms

Get Employee Input Form

Get a SmartHR employee information collection form by ID.

smarthr.get_employee_input_form

List Payment Periods

List SmartHR payment period records with pagination.

smarthr.list_payment_periods

Get Payment Period

Get a SmartHR payment period by ID.

smarthr.get_payment_period

List Bank Account Settings

List SmartHR bank account setting records with pagination.

smarthr.list_bank_account_settings

Create Employee

Create a SmartHR employee. No employee fields are mandatory; attachments accept file URLs.

smarthr.create_employee

Update Employee

Update only the supplied SmartHR employee fields. SmartHR prevents clearing populated identity fields; attachments accept file URLs.

smarthr.update_employee

Delete Employee

Delete a SmartHR employee record.

smarthr.delete_employee

Clear Employee Departments

Clear all department assignments on a SmartHR employee without deleting the employee or department records.

smarthr.clear_employee_departments

Invite Employee

Send or resend an invitation to the employee email address. The inviter must be an administrator; the invited user receives member permissions. Already accepted invitations cannot be resent.

smarthr.invite_employee

List Employees

List SmartHR employees with pagination.

smarthr.list_employees

List Companies

List SmartHR companies with pagination.

smarthr.list_companies

List Departments

List SmartHR departments with pagination.

smarthr.list_departments

List Employment Types

List SmartHR employment types with pagination.

smarthr.list_employment_types

List Custom Fields

List SmartHR custom employee fields with pagination.

smarthr.list_custom_fields

List Custom Field Groups

List SmartHR custom employee field groups with pagination.

smarthr.list_custom_field_groups

List Business Establishments

List SmartHR business establishments with pagination.

smarthr.list_business_establishments

Get Employee

Get a SmartHR employee by ID.

smarthr.get_employee

Get Department

Get a SmartHR department by ID.

smarthr.get_department

Get Employment Type

Get a SmartHR employment type by ID.

smarthr.get_employment_type

Create Department

Create a SmartHR department.

smarthr.create_department

Update Department

Partially update a SmartHR department, preserving unspecified attributes. SmartHR requires name.

smarthr.update_department

Replace Department

Replace a SmartHR department. Unspecified attributes are cleared by SmartHR.

smarthr.replace_department

Discontinue Department

Discontinue a SmartHR department on its last active date. The date must be in the past; scheduled employee changes can prevent discontinuation.

smarthr.discontinue_department

Frequently Asked Questions

Who can create the access token?

A SmartHR administrator creates the token and chooses its resource and employee-field permissions.

What is the difference between updating and replacing a department?

Partial updates preserve omitted attributes. Full replacement clears omitted attributes. Both require the department name.

How do I discontinue a department?

Provide its last active date, which must be in the past. Scheduled employee changes can prevent the operation.

Can I edit employee and payroll records?

Employee creation, updates, invitations, deletion, and document attachments are supported. Payroll and bulk import workflows are not yet included as dedicated actions.

Who can send an employee invitation?

Select an administrator user as the inviter. The invitation goes to the email address on the employee record and grants member permissions. An invitation already accepted cannot be resent.