---
title: "Upsert Onboarding Status"
method: PUT
path: "/apiHub/security/v1/companies/b6001/companyOnboardingStatuses"
tags: ["Client Onboarding"]
---

# Upsert Onboarding Status

`PUT /apiHub/security/v1/companies/b6001/companyOnboardingStatuses`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/apiHub/security/v1/companies/b6001/companyOnboardingStatuses`
- Auth: none declared

> 🚧 Partner Restricted
> 
> The Partner Onboarding API is only available to approved partners who have signed a Paylocity Technology Partnership Agreement. If you are not yet a partner and are interested, [please reach out to our team](https://www.paylocity.com/contact/partner-form/) to discuss partnership opportunities.

**Summary Description**

The new Partner Onboarding API is designed to enable our partners to onboard customers through our Paylocity Marketplace-initiated workflow. Approved partners will utilize the API to provision a client onto a specific integration. This API provides an endpoint that allows partners to upsert the status of the integration, using the Paylocity companyId specified in the request body. Partners can update the companyOnboardingStatus to one of four options: InProgress, Approved, Rejected or Suspended. If approved the partner will be able to sync the requested client data through the API.

## Headers

- `testMode` boolean

## Request body

- UpsertCompanyOnboardingDto: The onboarding details.
  - `companyId` string, nullable: The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity. **Allowable Values:** 9 char max
  - `onboardingStatus` 'InProgress' | 'Approved' | 'Rejected' | 'Suspended': The status to indicate the onboarding stage for a customer where the account form was filled up and is currently under review by your team.

## Response `201`

Created - Resource has been created.

- UpsertCompanyOnboardingDto: The onboarding details.
  - `companyId` string, nullable: The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity. **Allowable Values:** 9 char max
  - `onboardingStatus` 'InProgress' | 'Approved' | 'Rejected' | 'Suspended': The status to indicate the onboarding stage for a customer where the account form was filled up and is currently under review by your team.

## Other responses

- `204`: No Content - Resource has been updated.
- `400`: Bad Request - Returns the details of the error.
- `404`: Not Found - Returns the details of the error.
- `415`: Unsupported Media Type - Returns the details of the error.

---

[API](https://skmtc.dev/paylocity/apis/partner-onboarding-api.md) - [All operations](https://skmtc.dev/paylocity/apis/partner-onboarding-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/partner-onboarding-api/revisions/65f50fccface?raw)