sesame-hr

n8n community node for Sesame HR: employees, time tracking (clock in/out, work entries), vacation and absence requests, plus a trigger.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: ricardonldev

Documentation

n8n-nodes-sesame-hr

n8n community node for Sesame HR: employees, time tracking and vacation or absence requests, through the official Sesame public API.

Operations

Sesame HR node

Resource Operations
Employee Create, Get, Get Many (filter by email, code, ID number, status, last update), Update (only the fields you set change)
Work Entry (time tracking) Clock In, Clock Out, Create (past entry with start and end), Get Many (filter by employee, dates, last update)
Vacation Request Get Many (filter by status, employee, dates), Accept, Reject
Absence Request Get Many, Accept, Reject

The node can also be used as a tool by AI agents.

Sesame HR Trigger (polling): new work entry (clock-in), new vacation request or new absence request.

Credentials

  1. In Sesame, open Settings > Integrations > API and create a token.
  2. In n8n, create a Sesame HR API credential with the token and your data region (shown next to your tokens, for example eu1).

Examples

  • Send a Slack or email message to the manager when a vacation request arrives, and accept or reject it from a form.
  • Clock employees in and out from another system (a door, a kiosk, a chat command).
  • Export the month's work entries to a spreadsheet for payroll.

Notes

  • Clock In and Clock Out need an Origin (web, mobile, wall or watch) that is allowed in your Sesame settings. The official docs require this field but do not list it on that page; the values come from Sesame's check origins configuration.
  • Sesame does not take a comment when accepting a vacation request, so the node only sends it for rejections and absence requests.
  • Sesame allows 1,000 requests per minute per company.

Compatibility

Tested against a mock that checks every request against the official Sesame OpenAPI definitions (paths, query parameters, required fields, formats and allowed values), both in unit tests and inside n8n 2.40.7. Not yet tested against a live Sesame account.

Development

npm install
npm run build
node scripts/fetch-spec.mjs   # downloads the official API definitions used by the tests
npm test

License

MIT

Discussion