Employee position

Webhook topics and example payloads for employee position records.

Alongside an employee's profile attributes (name, hire date, and so on), PeopleForce keeps separate records for position and salary. To preserve the history of promotions and other changes, add a new record rather than editing the existing one.

The position record emits these webhooks:

  • employee_position_create — a position record is added
  • employee_position_update — a position record is updated

Both fire immediately for any employee, active or terminated.

Employee position created

Action: employee_position_create.

{
  "action": "employee_position_create",
  "data": {
    "id": 224222,
    "attributes": { "effective_on": "2022-12-01" },
    "employee": {
      "id": 133710,
      "employee_number": "IT-1029",
      "first_name": "Volodymyr",
      "last_name": "Markovich",
      "email": "mv@example.com"
    },
    "reporting_to": { "id": 10277, "first_name": "Pahney", "last_name": "Zhelezo" },
    "position": { "id": 11943, "name": "Senior Developer" },
    "department": { "id": 5094, "name": "IT" },
    "division": { "id": 1819, "name": "Europe" },
    "location": { "id": 28693, "name": "Vinnytsia" },
    "meta": {
      "created_at": "2022-09-21T14:57:29.151+01:00",
      "updated_at": "2022-09-21T14:57:29.151+01:00"
    }
  }
}

Employee position updated

Action: employee_position_update. The payload shape matches employee_position_create, with the updated values.

On this page