You can configure a webhook to be triggered on any custom attribute value change by visiting Settings > Automations > Create automation.... then select either a worker or applicant source, a relevant trigger/filter combination for your use case, and as Action select "Send a webhook...".
This opens a panel that lets you select whether you want to send the applicant or worker payload in the webhook body, as well as the webhook URL and Authentication key (this will be set as the Authorization header). Webhooks are sent as POST.
When the conditions are met, the following data will be sent to the configured URL (as an example this is a worker payload; a similar payload will be sent for the applicant version of the webhook):
{
"worker": {
"_id": "6916f97536b4690e60234ecf",
"createdAt": "2025-11-14T09:42:13.646Z",
"createdBy": "6cc9c100-6f11-4d20-8c1c-8d5389f63869",
"lastUpdatedAt": "2025-11-14T09:43:25.601Z",
"lastUpdatedBy": "6cc9c100-6f11-4d20-8c1c-8d5389f63869",
"firstname": "Test",
"lastname": "Profile",
"displayFullName": "Test Profile",
"dashboardUrl": {
"slug": "test_worker-461nf3q"
},
"personalEmail": {
"email": "[email protected]"
},
"mobilePhone": {
"number": ""
},
"locale": "en-US",
"companyUuid": "4651064c-ac9a-4063-9fe1-1c356843a93c",
"people": {
"uuid": "b097f9c0-2936-45d3-ab68-54614ac22940",
"index": 1,
"locked": false,
"reasons": []
},
"startDate": "",
"employmentStatus": {
"type": "created",
"subtype": "employee"
},
"jobUuid": null,
"jobIdentifiers": [],
"locationUuids": [],
"einUuid": "3bd3f695-7823-4779-9f10-5137bd895d78",
"segmentEnabled": true,
"segmentUuids": [
"aa8f239a-db29-44e0-891f-6d771f06b005",
"2e3c08ea-9894-452a-abe3-6830a5feb8de",
"382a1c69-f048-4436-9ee1-6920bbd885f5"
],
"messagingEnabled": true,
"ssoEnabled": false,
"isTestWorker": true,
"importUpdatesLocked": false,
"technicalOptions": {
"lockEin": false
},
"securityGroupUuids": [],
"hasBackendRole": false,
"uuid": "0be2b9f3-72e2-4ceb-a71d-4ffc7b4b7e91",
"tags": [],
"customAttributes": [
{
"customAttributeUuid": "56606812-8f05-4ea3-8a17-642da842317c",
"key": "requirement_drivers_license_status",
"value": "OUT"
},
{
"customAttributeUuid": "34953ed2-4774-4c78-b99d-aec2f9ea1f87",
"key": "requirement_drivers_license_expiration_date",
"value": null
},
{
"customAttributeUuid": "ad77dd94-2a32-4059-bd61-0c7eede96ba1",
"key": "in_compliance",
"value": false
},
{
"customAttributeUuid": "6c0c458d-007b-4200-9775-2ccb873bc3b7",
"key": "onboard_status",
"value": "notStarted"
},
{
"customAttributeUuid": "ad0bf82d-3bc5-40e7-a032-d9e73f6fa32f",
"key": "preboarding_type_flows_completed",
"value": false
},
{
"customAttributeUuid": "ba591bb9-1e12-4b29-92a0-69f20d95f5a0",
"key": "onboarding_type_flows_completed",
"value": false
},
{
"customAttributeUuid": "960bcc39-1adc-4df2-b48d-afcbbc899a42",
"key": "onboard_completed",
"value": true
}
],
"payRateExceptions": [],
"__v": 0,
"company": {
"uuid": "4651064c-ac9a-4063-9fe1-1c356843a93c",
"slug": "fountain-s-wnsa4",
"name": "Fountain"
},
"ein": {
"ein": "12-3456789",
"label": "Tutu",
"uuid": "3bd3f695-7823-4779-9f10-5137bd895d78"
},
"jobs": [],
"locations": [],
"smsOptOut": {
"optedOutAt": null,
"status": false,
"optedOutByAudience": "system",
"optedOutByAudienceUuid": "",
"optedOutOverrideByAudienceUuid": null,
"optedOutOverrideAt": null
},
"applicantId": "",
"applicantSource": "",
"dateOfBirth": "",
"externalId": "",
"externalSource": "",
"hireDate": "",
"homeAddress": {
"address1": "",
"address2": "",
"city": "",
"zip": "",
"state": "",
"country": ""
},
"middlename": "",
"terminationDate": "",
"timezone": "UTC"
}
}