Action: Update Employee

BambooHR Operation

The Update Employee action modifies an employee's existing record with new or updated information.

Example User Story

I want to update an employee's details in BambooHR so that I can keep employee records accurate and up-to-date.

Fields

Field Name	Field Type	Required
employeeId	String	Yes
firstName	String	No
lastName	String	No
jobTitle	String	No
workEmail	String	No
workPhone	String	No
department	String	No
location	String	No
status	String	No

Related Connections

BambooHR

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "update-employee",
  "state": "inDev",
  "meta": {
    "short": "Update Employee",
    "description": "Update an existing employee's details in BambooHR."
  },
  "input": [
    {
      "name": "employeeId",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The unique identifier for the employee in BambooHR."
      }
    },
    {
      "name": "firstName",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The first name of the employee."
      }
    },
    {
      "name": "lastName",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The last name of the employee."
      }
    },
    {
      "name": "jobTitle",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The job title of the employee."
      }
    },
    {
      "name": "workEmail",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The work email address of the employee."
      }
    },
    {
      "name": "workPhone",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The work phone number of the employee."
      }
    },
    {
      "name": "department",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The department of the employee."
      }
    },
    {
      "name": "location",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The location of the employee."
      }
    },
    {
      "name": "status",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The employment status of the employee.",
        "options": ["active", "inactive", "on leave"]
      }
    }
  ],
  "output": [
    {
      "name": "success",
      "type": "Boolean",
      "selector": ["success"],
      "meta": {
        "description": "Indicates whether the update was successful."
      }
    },
    {
      "name": "employeeId",
      "type": "String",
      "selector": ["employeeId"],
      "meta": {
        "description": "The unique identifier for the updated employee."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/api/gateway.php/v1/employees/{{employeeId}}",
        "headers": {
          "Content-Type": "application/json",
          "Accept": "application/json"
        },
        "bodyTemplate": {
          "value": "{\n  \"firstName\": \"{{firstName}}\",\n  \"lastName\": \"{{lastName}}\",\n  \"jobTitle\": \"{{jobTitle}}\",\n  \"workEmail\": \"{{workEmail}}\",\n  \"workPhone\": \"{{workPhone}}\",\n  \"department\": \"{{department}}\",\n  \"location\": \"{{location}}\",\n  \"status\": \"{{status}}\"\n}",
          "placeholders": [
            {
              "name": "employeeId",
              "type": "String",
              "description": "The unique identifier for the employee in BambooHR.",
              "required": true
            },
            {
              "name": "firstName",
              "type": "String",
              "description": "The first name of the employee.",
              "required": false
            },
            {
              "name": "lastName",
              "type": "String",
              "description": "The last name of the employee.",
              "required": false
            },
            {
              "name": "jobTitle",
              "type": "String",
              "description": "The job title of the employee.",
              "required": false
            },
            {
              "name": "workEmail",
              "type": "String",
              "description": "The work email address of the employee.",
              "required": false
            },
            {
              "name": "workPhone",
              "type": "String",
              "description": "The work phone number of the employee.",
              "required": false
            },
            {
              "name": "department",
              "type": "String",
              "description": "The department of the employee.",
              "required": false
            },
            {
              "name": "location",
              "type": "String",
              "description": "The location of the employee.",
              "required": false
            },
            {
              "name": "status",
              "type": "String",
              "description": "The employment status of the employee.",
              "required": false,
              "options": ["active", "inactive", "on leave"]
            }
          ]
        }
      }
    }
  ]
}