HomeGuidesAPI ReferenceChangelogDiscussions
Guides
These docs are for v1.0. Click to read the latest docs for v2024-10-01.

Employee Created

When?

When creating a new employee, after submitting the form, this event gets triggered.

2048

Click on the create new employee

990

After submitting the form, the webhook will get triggered. (invitation is not required for this event)

How?

Example curl to subscribe.

curl --request POST \
     --url https://api.factorialhr.com/api/v1/webhooks \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer TOKEN' \
     --header 'Content-Type: application/json' \
     --data '
{
     "type": "employee_created",
     "target_url": "https://foo.com/webhooks/employee_created"
}
'

What?

What does this webhooks send in the payload.

{
  "id": 52,
  "first_name": "Bob",
  "last_name": "Macri",
  "email": "[email protected]",
  "invited_on": "2021-10-22"
}

Why?

Why would I subscribe to this event?

  • Send an email from another platform to users that get created in Factorial.
  • Create a Zapier.com automation with employees.
  • Create a user in another platform or application that, on webhooks triggered, will use the api to fetch all employee info and create the user.
  • Create access info for a user in an external access platform or device.