Company Onboarding Events
Webhook events sent while a company you created moves through onboarding.
Audience: company. These events tell you what is happening to a company you created with the Company Onboarding API. They are sent to the webhook endpoint of the company, which you can set when you create the company or later with the Webhook Endpoints API, and they use the same envelope, signature, and retry behavior as every other Everee webhook event. Verify each event as described in Authenticating events.
The companyId in the envelope is the company's ID. In every event below, data.object always includes companyId.
Events are notifications. They can arrive more than once, so make your handler idempotent, and read Get onboarding status for the current state.
Status Changed
Sent when the company's onboarding status changes: it was submitted (UNDER_REVIEW), approved (APPROVED), declined (DECLINED), or withdrawn (WITHDRAWN).
Webhook event type: company-onboarding.status-changed
{
"companyId": 10011,
"status": "APPROVED"
}Signature Requested
Sent when the company's signer can sign the agreements: the draft is complete and Everee has loaded the contract terms. It is also sent when updated documents need a new signature. signatureReason is FIRST_REQUEST the first time and RE_SIGN_REQUIRED after a previous signature was voided. Create a signing session in response. If your customers agree to terms under your own agreement, the signature covers Everee's ACH Debit Authorization and IRS Form 8655 only, and is requested once the customer's consent is reported.
Webhook event type: company-onboarding.signature-requested
{
"companyId": 10011,
"contractVersion": 1,
"signatureReason": "FIRST_REQUEST"
}contractVersion counts the rounds of signing: it increases by one each time a new signature is requested.
Contract Signed
Sent when the signer has signed the agreements.
Webhook event type: company-onboarding.contract-signed
{
"companyId": 10011,
"contractVersion": 1
}Contract Executed
Sent when Everee has countersigned the agreements. The executed documents are then available from Download a signed contract document.
Webhook event type: company-onboarding.contract-executed
{
"companyId": 10011,
"contractVersion": 1
}Contract Voided
Sent when a signature is voided because the information on the documents changed. A new company-onboarding.signature-requested event follows. voidReason is DATA_CHANGED, DOCUMENT_CORRECTION, or OTHER. See Changing information after signing.
Webhook event type: company-onboarding.contract-voided
{
"companyId": 10011,
"contractVersion": 1,
"voidReason": "DATA_CHANGED"
}Request Created
Sent when Everee needs something from you during review. Read the request, including its message, with List requests. See Responding to requests.
Webhook event type: company-onboarding.request-created
{
"companyId": 10011,
"requestId": 5512,
"requestType": "DOCUMENT_NEEDED",
"documentType": "PROOF_OF_BUSINESS_ADDRESS"
}documentType appears only on document requests, and personRef only on requests about a particular person.
Request Resolved
Sent when a request is resolved: you answered it, or the thing it asked for is done. It has the same fields as company-onboarding.request-created.
Webhook event type: company-onboarding.request-resolved
{
"companyId": 10011,
"requestId": 5512,
"requestType": "DOCUMENT_NEEDED",
"documentType": "PROOF_OF_BUSINESS_ADDRESS"
}Identity Verification Changed
Sent when the identity verification status of a person you provided changes. personRef identifies the person, as in the identityVerification list of Get onboarding status. identityVerificationStatus is one of GETTING_READY, LINK_SENT, IN_REVIEW, EXPIRED_CONTACT_US, or VERIFIED. See Identity verification.
Webhook event type: company-onboarding.identity-verification-changed
{
"companyId": 10011,
"personRef": "control-person",
"identityVerificationStatus": "VERIFIED"
}Requirements Changed
Sent when Everee's compliance requirements change in a way that affects a company that is not yet completed. requirementsAdded lists the readiness codes of documents that are now required, and requirementsRemoved those that no longer are. journeyVersion is the version of Everee's requirements now applied. Read Get onboarding status for the full picture. See Requirements can change.
Webhook event type: company-onboarding.requirements-changed
{
"companyId": 10011,
"requirementsAdded": ["IRS_EIN_LETTER"],
"requirementsRemoved": [],
"journeyVersion": 2
}Payroll History File Added
Sent when a payroll history file is uploaded, through the API or by the company's admin in the payroll history upload. source is PARTNER or EMBEDDED.
Webhook event type: company-onboarding.payroll-history-file-added
{
"companyId": 10011,
"fileId": 991,
"fileName": "2026-q3-payroll-register.xlsx",
"source": "EMBEDDED"
}Payroll History File Reviewed
Sent each time Everee accepts or rejects a payroll history file. reviewStatus is ACCEPTED or REJECTED. A rejected file has a reviewNote saying why, written to be shown to the company's admin.
Webhook event type: company-onboarding.payroll-history-file-reviewed
{
"companyId": 10011,
"fileId": 991,
"fileName": "2026-q3-payroll-register.xlsx",
"source": "EMBEDDED",
"reviewStatus": "REJECTED",
"reviewNote": "This register is missing employer taxes. Please export it again with employer taxes included."
}Payroll History Status Changed
Sent when the company's payroll history status changes. status and previousStatus are NOT_RECEIVED, RECEIVED, CHANGES_REQUESTED, IN_PROGRESS, IMPORTED, NOT_NEEDED or NONE_DECLARED. See Where it stands.
Webhook event type: company-onboarding.payroll-history-status-changed
{
"companyId": 10011,
"status": "RECEIVED",
"previousStatus": "NOT_RECEIVED"
}Go-Live Scheduled
Sent when Everee sets, moves or removes the company's go-live date: the first day of the first pay period Everee pays. goLiveDate is null when Everee removed the date, and previousGoLiveDate is null when there was none before. Changing your own target go-live date doesn't send it.
Webhook event type: company-onboarding.go-live-scheduled
{
"companyId": 10011,
"goLiveDate": "2026-12-07",
"previousGoLiveDate": null
}Went Live
Sent when the company goes live and can run payroll on Everee. goLiveDate is null when Everee never set one. A company that stops being live and goes live again sends it again.
Webhook event type: company-onboarding.went-live
{
"companyId": 10011,
"goLiveDate": "2026-12-07",
"liveAt": "2026-12-07T15:02:11Z"
}Updated 5 days ago