Webhook Events Overview
The Everee platform sends notifications when certain events occur. These notifications are webhook events published to an endpoint listening for these events in your platform.
During account configuration, you can provide a Target URL—an HTTPS URL that will receive webhook event payloads—to enable webhook delivery from Everee to your platform. Talk to your Partner Success manager about enabling webhook events.
When a webhook event is sent to your target URL, the payload has the following structure:
{
id: string, unique ID of the event
companyId: number, unique ID of the client Company instance in Everee
type: string, event type name (see above)
timestamp: number, epoch timestamp of the event’s occurrence
data: object, with shape: {
object: object, with shape: {
[relevant object structure; see below]
}
}
version: string, version of the payload structure; currently always "1"
}
Worker Onboarding Completed
This event is sent when a worker has completed onboarding in Everee and is ready to receive funds.
Webhook event type
: worker.onboarding-completed
Webhook event data.object
has the following structure:
{
"workerId": "workerId",
"externalWorkerId": "externalWorkerId",
"onboardingStatus": "COMPLETE",
"onboardingComplete": true
}
Payment Paid
This event is sent when a payment to a worker has been successfully transferred (or for ACH, has been submitted to the ACH network for settlement).
This event is not available by default, and requires Everee review before enabling for a customer account.
Webhook event type
: payment.paid
Webhook event data.object
has the following structure:
{
"workerId": "workerId",
"externalWorkerId": "externalWorkerId",
"paymentId": "98765432"
}
Payment ACH Deposit Returned
This event is sent when a payment ACH deposit has been returned by the destination bank.
This is most often due to an incorrect account/routing number in Everee. The client should prompt the worker to update their account/routing number information. When account/routing number information has been updated, Everee will automatically retry the deposit as soon as possible.
Webhook event type
: payment.deposit-returned
Webhook event data.object
has the following structure:
{
"workerId": "workerId",
"externalWorkerId": "externalWorkerId",
"paymentId": 123456789
}
Worker Onboarding Locked
This event is sent when a worker's onboarding workflow has been locked.
When an onboarding is locked, a worker cannot retry or continue onboarding until their onboarding is unlocked. This can happen when a worker enters a duplicate or invalid taxpayer identifier number (such as an SSN or ITIN) multiple times.
Webhook event type
: worker.onboarding-locked
Webhook event data.object
has the following structure:
{
"workerId": "workerId",
"externalWorkerId": "externalWorkerId",
"onboardingLockedAt": "1682736572", // Epoch seconds
"onboardingLocked": true
}
Updated 4 months ago