Skip to main content
Oyster HR
Oyster HR
59 actions · 45 events · 1 auth method
HRIS

Authentication

OAuth 2.0

Connect using OAuth 2.0 by creating a Developer App in the Oyster Developer Portal.Guides: Connector Profile, Link Account
Actions
59 actions
Action
Description
Get Company
Retrieve company details for the authenticated organization
List Webhooks
Retrieve all webhook endpoints registered for the authenticated organization
List Webhook Dispatches
Retrieve all webhook dispatches for the authenticated Developer application
Delete Webhook
Delete a webhook endpoint by ID
List Departments
Retrieve a paginated list of departments
List Engagements
Retrieve a paginated list of engagements (employees and contractors)
Get Engagement
Retrieve details of a specific engagement by ID
List Engagement Allowances
Retrieve a paginated list of allowances for a specific engagement
List Engagement Bonuses
Retrieve a paginated list of bonuses for a specific engagement
Update Personal Details
Update personal details for an employment
List Engagement Documents
Retrieve a paginated list of documents for a specific engagement
List Engagement Payslips
Retrieve a paginated list of payslips for a specific engagement
List Contract Changes
Retrieve all contract change requests across engagements
Get Contract Change
Retrieve details for a specific contract change request
Create Contract Change
Create a new contract change request for an engagement
Cancel Contract Change
Cancel a contract change request
List Time Off Entitlements
Retrieve a paginated list of time off entitlements
Get Time Off Entitlement
Retrieve entitlements for an individual engagement
List Time Off Requests
Retrieve a paginated list of time off requests
Get Time Off Request
Retrieve an individual time off request by ID
Create Time Off Request
Create a new time off request for an engagement
Approve Time Off Request
Approve a pending time off request
Reject Time Off Request
Reject a pending time off request
List Expenses
Retrieve all expenses
Get Expense
Retrieve an individual expense by ID
Create Expense
Create a new expense record
Delete Expense
Delete an expense record by ID
Approve Expense
Approve a pending expense
Decline Expense
Decline a pending expense
List Payroll
Retrieve a paginated list of payroll entries
Get Payroll Item
Retrieve a single payroll entry by ID
List Payroll Records
Retrieve payroll records for an individual payroll
List Payroll Changes
Retrieve all payroll changes
Get Payroll Change
Retrieve a single payroll change by ID
Create Payroll Change
Create a payroll change for an engagement
Update Payroll Change
Update an existing payroll change
Cancel Payroll Change
Cancel a payroll change
Get Default Payroll Changes Source Types
Retrieve default payroll changes rulesets for source types
Get Default Payroll Changes Ruleset
Retrieve default payroll changes ruleset
Get Payroll Changes Source Types
Retrieve payroll changes rulesets for source types
Get Payroll Changes Ruleset
Retrieve payroll changes ruleset
List Bank Accounts
Retrieve bank accounts for the company
Get Bank Account
Retrieve bank account details by ID
List Time Sheets
Retrieve all time sheets for the company
Get Time Sheet
Retrieve an individual time sheet by ID
Create Time Sheet
Create a new time sheet for an engagement
Create Time Sheet Entry
Create a new entry in a time sheet
Submit Time Sheet
Submit a time sheet for approval
Confirm Time Sheet
Confirm a time sheet
Update Time Sheet Entry
Update an existing time sheet entry
Delete Time Sheet Entry
Delete a time sheet entry
Delete Time Sheet
Delete a time sheet
Create Hiring Employment
Create a new hiring employment record
Get Hiring Employment
Retrieve an individual hiring employment by ID
Submit Hiring Employment
Submit a hiring employment for processing
Invite Team Member
Send invitation to a team member for a hiring employment
Get Hiring Employment Tasks
Retrieve hiring process tasks for an employment
Update Hiring Employment
Update a draft hiring employment record
Delete Hiring Employment
Delete a draft hiring employment record
Events
|
45 events
Event
Description
Tags
Hiring Agreement Accepted
Emitted when a team member accepts their employment or contractor agreement. Maps to OysterHR event `hiring.agreement_ac…
Hiring
Hiring Agreement Drafted
Emitted when a new employment or contractor agreement draft is created for review. Maps to OysterHR event `hiring.agreem…
Hiring
Hiring Agreement Signed
Emitted when an employment or contractor agreement is fully signed by all parties. Maps to OysterHR event `hiring.agreem…
Hiring
Hiring Agreement Updated
Emitted when an existing employment or contractor agreement is modified with new terms or details. Maps to OysterHR even…
Hiring
Hiring Agreement Verified
Emitted when an employment or contractor agreement passes verification checks. Maps to OysterHR event `hiring.agreement_…
Hiring
Hiring Contractor Engaged
Emitted when a contractor engagement becomes active and the contractor is ready to begin work. Maps to OysterHR event `h…
Hiring
Hiring Contractor Submitted
Emitted when a new contractor hiring request is submitted for processing. Maps to OysterHR event `hiring.contractor_subm…
Hiring
Hiring Employment Engaged
Emitted when an employee engagement becomes active and the employee officially starts their role. Maps to OysterHR event…
Hiring
Hiring Employment Onboarding Completed
Emitted when a new employee completes all onboarding steps and requirements. Maps to OysterHR event `hiring.employment_o…
Hiring
Hiring Employment Submitted
Emitted when a new employee hiring request is submitted for processing. Maps to OysterHR event `hiring.employment_submit…
Hiring
Hiring Oyster Invitation Accepted
Emitted when a team member accepts their invitation to join the Oyster platform. Maps to OysterHR event `hiring.oyster_i…
Hiring
Hiring Payroll Team Member Engaged
Emitted when a payroll team member engagement becomes active and payroll processing begins. Maps to OysterHR event `hiri…
Hiring
Hiring Payroll Team Member Submitted
Emitted when a new payroll team member hiring request is submitted for processing. Maps to OysterHR event `hiring.payrol…
Hiring
Hiring Task Updated
Emitted when a hiring-related task is updated, such as a background check or document submission status change. Maps to…
Hiring
Offboarding Approved
Emitted when an offboarding request is approved and the termination process can proceed. Maps to OysterHR event `offboar…
Offboarding
Offboarding Cancelled
Emitted when a previously initiated offboarding process is cancelled and the engagement continues. Maps to OysterHR even…
Offboarding
Offboarding Engagement Terminated
Emitted when an engagement is fully terminated and the team member is offboarded from the company. Maps to OysterHR even…
Offboarding
Offboarding Initiated
Emitted when an offboarding process is started for a team member, beginning the termination workflow. Maps to OysterHR e…
Offboarding
Time Off Request Created
Emitted when a team member submits a new time off request for approval. Maps to OysterHR event `time_off.request_created…
Time Off
Time Off Request Modified
Emitted when an existing time off request is modified, such as date or duration changes. Maps to OysterHR event `time_of…
Time Off
Time Off Request Status Changed
Emitted when a time off request status changes, such as being approved, declined, or cancelled. Maps to OysterHR event `…
Time Off
Time Tracking Time Sheet Approved
Emitted when a submitted time sheet is approved by a manager or administrator. Maps to OysterHR event `time_tracking.tim…
Time Tracking
Time Tracking Time Sheet Created
Emitted when a new time sheet is created for a team member’s work period. Maps to OysterHR event `time_tracking.time_she…
Time Tracking
Time Tracking Time Sheet Deleted
Emitted when a time sheet is deleted from the system. Maps to OysterHR event time_tracking.time_sheet_deleted.
Time Tracking
Time Tracking Time Sheet Entries Modified
Emitted when individual time entries within a time sheet are added, updated, or removed. Maps to OysterHR event `time_tr…
Time Tracking
Time Tracking Time Sheet Pending Approval
Emitted when a time sheet is submitted and awaiting manager or administrator approval. Maps to OysterHR event `time_trac…
Time Tracking
Time Tracking Time Sheet Submitted
Emitted when a team member submits their completed time sheet for the work period. Maps to OysterHR event `time_tracking…
Time Tracking
Engagements Document Uploaded
Emitted when a new document is uploaded to a team member’s engagement record. Maps to OysterHR event `engagements.docume…
Engagements
Engagements Document Updated
Emitted when an existing document on a team member’s engagement record is modified. Maps to OysterHR event `engagements…
Engagements
Engagements Document Deleted
Emitted when a document is removed from a team member’s engagement record. Maps to OysterHR event `engagements.document_…
Engagements
Engagements Payslip Uploaded
Emitted when a new payslip is uploaded and made available for a team member. Maps to OysterHR event `engagements.payslip…
Engagements
Engagements Payslip Updated
Emitted when an existing payslip record is modified or corrected. Maps to OysterHR event engagements.payslip_updated.
Engagements
Engagements Payslip Deleted
Emitted when a payslip record is removed from a team member’s engagement. Maps to OysterHR event `engagements.payslip_de…
Engagements
Expenses Expense Approved
Emitted when a submitted expense claim is approved for reimbursement. Maps to OysterHR event expenses.expense_approved
Expenses
Expenses Expense Created
Emitted when a team member submits a new expense claim for approval. Maps to OysterHR event expenses.expense_created.
Expenses
Expenses Expense Declined
Emitted when a submitted expense claim is declined and will not be reimbursed. Maps to OysterHR event `expenses.expense_…
Expenses
Contract Change Applied
Emitted when an approved contract change takes effect on the engagement terms. Maps to OysterHR event `contract.change_a…
Contract
Contract Change Approved
Emitted when a requested contract change is approved and ready to be applied. Maps to OysterHR event `contract.change_ap…
Contract
Contract Change Cancelled
Emitted when a pending contract change request is cancelled before being applied. Maps to OysterHR event `contract.chang…
Contract
Contract Change Requested
Emitted when a change to an existing contract is requested, such as salary adjustment or role change. Maps to OysterHR e…
Contract
Contract Change Submitted
Emitted when a contract change request is formally submitted for review and approval. Maps to OysterHR event `contract.c…
Contract
Contract Change Updated
Emitted when the details of a pending contract change request are modified before approval. Maps to OysterHR event `cont…
Contract
Payments Charge Paid
Emitted when a payment charge is successfully processed and funds are transferred. Maps to OysterHR event `payments.char…
Payments
Payments Charge Failed
Emitted when a payment charge fails to process due to insufficient funds or other payment issues. Maps to OysterHR event…
Payments
Payments Charge Group Paid
Emitted when a group of payment charges is successfully processed as a batch. Maps to OysterHR event `payments.charge_gr…
Payments

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See the Projects Guide.
2

Configure the Connector

Enable the connector and set up a connector profile in your project. See Managing Connectors.
https://stackone-logos.com/api/oyster/filled/png

Connector Profile

Oyster HR - OAuth 2.0
3

Link an Account

Connect an account using StackOne Hub or Auth Link.
https://stackone-logos.com/api/oyster/filled/png

Link Account

Oyster HR - OAuth 2.0
4

Use Actions

Invoke actions using one of the methods below: