Build Oyster API Integration Faster with Finch
Oyster, a distributed HR solution founded in January 2020, provides a global employment platform for employers. Today, they support hiring in 180+ countries and save employers the hassle of setting up local entities for each country. They also enable payroll automation and country-specific benefits. Oyster is recognized as a leader in global employment platforms by G2.
Powering integrations for hundreds of platforms
Build with confidence
Why developers love building with Finch
Market-leading coverage
Instantly support 180+ systems (and counting) compatible with our normalized data structure and as we add new systems, turn them on with one click.
Enterprise-grade security
Trust Finch’s infrastructure that enforces TLS 1.2 for data in transit and encrypts data at rest using AES 256 bit encryption.
Read and write functionality
Seamlessly read company, census, and payroll data, while writing deductions and benefits contributions changes directly into the source of truth.
Best in class developer experience
Integrate Finch in hours with just a few lines of code and turn on the ability sync data with employers in as little as 30 seconds.
Unified API
One API to unite every provider
Finch standardizes employment data across every provider. So you don't have to.
- Company
Read basic company data including legal name, EIN, bank accounts, entity type, and locations.
Read the company API - Directory
Read company directory and organization structure including the names of individuals and the reporting structure.
Read the directory API - Individual
Read individual data including name, email, phone number, date of birth, and residence.
Read the individual API - Employment
Read employment data including income, employment type, start date, end date, and location.
Read the employment API - Payment
Read all payments made the company including pay date, pay periods, and gross and net pay.
Read the payment API - Pay Statement
Read all data on a specific pay statement including earnings, deductions, and taxes.
Read the pay statement API - Benefits
Read and write benefits information, including creating benefits and enrolling individuals.
Read the benefits API
FAQs
What percentage of the market uses Oyster HR?
Given that Oyster HR boasts over 4,500 customers, and there were 6.1 million employers in the United States as of 2019, Oyster is estimated to serve 0.07% of the U.S. employer market.
How can I access the employment data in Oyster HR?
To access your customers’ employment data in Oyster HR, you have two options:
- Build a custom 1:1 integration with Oyster via its public API, which enables automatic data sharing between the two apps.
- Build a single integration with Finch to access the employment data housed in Oyster along with 200+ other employment systems.
Does Oyster HR have a public API?
If you are an Oyster HR partner or customer, you can access its API. Read about Oyster’s APIs.
You must first create an account and gain access before you can start building. Typically, third-party developers must become official partners, pass technical requirements checks, and invest in business development efforts.
How long does it take to build Oyster integration?
That largely depends on the integration method you choose.
If you use Finch’s unified API to access the employment data in Oyster HR (alongside over 200 other HRIS and payroll systems), it can take as little as a few days. See our quickstart guide for more information.
If you instead decide to build a 1:1 integration leveraging Oyster’s public APIs, it can take weeks to months to receive your production keys. See Oyster’s developer portal for more information.
Where can I find developer documentation and support?
If you’re building a 1:1 integration using Oyster HR’s public APIs, the company’s developer portal is the best place to start. That’s where you’ll find technical guides, API references, and the company’s changelog.
If you’re integrating with Oyster HR via Finch’s unified API, navigate to our API docs. There, you’ll find a product demo, a quickstart guide for developers, an integration checklist, and developer guides, along with best practices to follow.
Of course, if you have any questions, we’d be happy to help answer them. Send your requests to developers@tryfinch.com.
When does it make sense to leverage a unified employment API?
Unified employment APIs help developers access data from payroll and HRIS systems employers use. Specifically, these APIs are useful for accessing data from a broad range of employment systems, or collecting detailed information about their customers’ payroll and benefits programs. If your use case requires integrations with three or more employment systems, a unified employment API could save you hundreds of engineering hours and developer resources.
Through a single integration, you can connect with over 200 employment systems (including Oyster)—unlocking up to 88% of the employer market. Once authorized by the employer, you’ll receive fresh data every 24 hours. From enterprise-grade security to read and write capabilities, Finch offers compelling benefits to employer-facing businesses of all shapes and sizes. Learn more.
Customer Stories
You’ll be in good company
.png)
Integrations
Access the global employment ecosystem
Create a best-in-class experience for your users today.
