Quick overview
This workflow receives a new-hire POST request and orchestrates onboarding by calling HR, IAM, IT provisioning, and SaaS application APIs in sequence, then returns a consolidated status report to the requester.
How it works
- Receives a new-hire payload via an n8n webhook endpoint.
- Validates required fields, normalizes the employee record, and prepares target API URLs and a request ID.
- Sends the employee data to the HR system API and records the returned status and employee identifier.
- Sends an identity provisioning request to the IAM API and captures the created user ID for downstream steps.
- Sends an IT provisioning request to create core IT resources (such as email and a ticket) and records the outcome.
- Sends a SaaS provisioning request to grant access to a configured app list and aggregates HR/IAM/IT/SaaS results into a single summary.
- Responds to the original webhook call with a JSON report and an HTTP status that reflects completed, partial, or failed provisioning.
Setup
- Configure the webhook URL (path:
employee-onboard) in your HR intake form, ATS, or other system that submits new-hire events.
- Replace the example endpoints (currently
httpbin.org) with your real HRIS, IAM/identity provider, IT service desk/provisioning, and SaaS provisioning API URLs.
- Add any required authentication for those APIs (for example, API keys or OAuth headers) in the HTTP Request configurations.
- Ensure the calling system sends the required fields (first name, last name, email, and start date), and optionally provide
simulateStatus for testing.