Build guide

Follow our project guide to successfully integrate Kota.

While you can integrate Kota Embedded in as little as 1 week, the following timeline assumes that your business has internal systems that add complexity to your Kota integration. With this in mind, we estimate that the total integration time can range from less than 1 week to up to 2 month for more advanced use-cases with global payroll considerations. Primary dependencies include engineering resources, internal system integrations, and change management across impacted teams.

Minimum requirements for an integration

Server-side implementation:

  1. Authentictae with Kota
  2. Integrate the necessary APIs calls to your platform
  3. Configure webhooks to handle Events
  4. Communicate required actions with Employers and their Employees

Learn more in our server-side integration page.

Frontend implementation:

  1. Include Kota’s Embedded SDK in your project
  2. Get your Embedded SDK session token
  3. Initialise the Employer and Employee UIs
  4. (Optional) Theme your integration

Learn more in our frontend integration page.

Advanced use-cases

Contribution Reports

Relevant for platforms involved in payroll. e.g. Payroll platforms, Employer of Record platforms and Enterprise Employers

Employers will always have access to their insurance carrier and should be able to retrieve invoices and cost reports from them directly, however, this is a very tedious manual process and for large and/or wide organisations this may be unsusintable - Kota’s contribution reports allow your system to programmatically handle complex contributions across tens of countries to enable scalable payroll systems, great reporting and get away from messy end of year benefit reconciliations.

Large platforms or employers with an interest in consuming benefit contribution reports should integrate with our Contribution Reports API - learn more by reading our Contribution Reports API documentation.