Person Change One

POST /People/Update/OneChange
Authorization key & Authorization date & Authorization hmac

This process updates a single people record. If there is a StrandVision record id or your employee id passed, there will be an exact match to update. If not, we search based on the sound of the first and last name. If a match is not found, a new record is added. If found, the person is updated. This returns the values after the update. *Secret Hmac Required. Do Not Cache this call.

Body

  • Custno number

    The optional customer number to retrieve

  • Person object
    Hide Person attributes Show Person attributes
    • FirstName string

      required contact first name

    • LastName string

      required contact last name

    • Emp_Id string

      Recommended people / staff id

    • Birthday string

      The recommended birthday preferably in the format MM-DD. If sent as YYYY-MM-DD format with a year, the year will be replaced with an invalid year.

    • HireDate string

      The recommended hire date for showing the years they have worked in YYYY-MM-DD format.

    • TermDate string

      The optional Termination Date if you want to display people who will leave soon in YYYY-MM-DD format.

    • Source_Id string

      optional employee or other id from the source database

    • Location string

      optional location code specified from the source database

    • Email string

      optional email address

    • NickName string

      optional name they go by

    • Phone string

      optional direct phone number

    • Web string

      optional link to their record on internal web site

    • Photo string

      optional location of uploaded photo

    • Gender string

      M for male, F for female, U for Unknown or Undisclosed

    • Dept string

      optional Department that they work in

    • Title string

      optional title of the employee

    • Skip string

      Skip Display Options (Birthday, Annivarsiary, Termination)

Responses

  • 200

    Person successfully updated

    Hide response attributes Show response attributes object
    • Id number

      the StrandVision record id needed for individual update or remove

    • Emp_Id string

      people / staff id

    • Created string

      date/time created

    • Deleted number

      Whether the staff member is deleted

    • Parent number

      Parent User Number

    • Custno number

      User Customer Number

    • DispGroup string

      the display group that this user is in

    • Source_Id string

      employee or other id from the source database

    • Location string

      location code specified from the source database

    • Email string

      email address

    • FirstName string

      contact first name

    • LastName string

      contact last name

    • NickName string

      name they go by

    • Phone string

      direct phone number

    • Web string

      link to their record on internal web site

    • Photo string

      location of uploaded photo

    • Gender string

      M for male, F for female, U for Unknown or Undisclosed

    • Dept string

      Department that they work in

    • Title string

      title of the employee

    • Birthday string

      Birthday with invalid year

    • HireDate string

      Hire Date

    • TermDate string

      Termination Date (if any)

    • Skip string

      Skip Display Options (Birthday, Annivarsiary, Termination)

    • DateLast string

      Last Date/Time used

    • DateEdit string

      Last Date/Time that the employee was updated
POST /People/Update/OneChange 
curl \
 -X POST https://Api.StrandVision.com/v1.0/People/Update/OneChange \
 -H "Authorization: X-apikey $ACCESS_TOKEN" \
 -H "Authorization: X-apidate $ACCESS_TOKEN" \
 -H "Authorization: X-apihmac $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"Custno":10028,"Person":{"FirstName":"Ingred","LastName":"Bergman","Emp_Id":1016,"Birthday":"12-04","HireDate":"2010-01-15","TermDate":0,"Source_Id":1016,"Location":"Washington","Email":"csstrand@strandvision.com","NickName":"string","Phone":"string","Web":"string","Photo":"https://strandvision.com/.?ImageDB=LG4FX874KHC52OFCA7RXL","Gender":"Female","Dept":"Quality Assurance","Title":"Quality Assurance Manager","Skip":"Birthdays"}}'
Request example 
{
  "Custno": 10028,
  "Person": {
    "FirstName": "Ingred",
    "LastName": "Bergman",
    "Emp_Id": 1016,
    "Birthday": "12-04",
    "HireDate": "2010-01-15",
    "TermDate": 0,
    "Source_Id": 1016,
    "Location": "Washington",
    "Email": "csstrand@strandvision.com",
    "NickName": "string",
    "Phone": "string",
    "Web": "string",
    "Photo": "https://strandvision.com/.?ImageDB=LG4FX874KHC52OFCA7RXL",
    "Gender": "Female",
    "Dept": "Quality Assurance",
    "Title": "Quality Assurance Manager",
    "Skip": "Birthdays"
  }
}
Request examples 
{
  "Custno": 10028,
  "Person": {
    "FirstName": "Ingred",
    "LastName": "Bergman",
    "Emp_Id": 1016,
    "Birthday": "12-04",
    "HireDate": "2010-01-15",
    "TermDate": 0,
    "Source_Id": 1016,
    "Location": "Washington",
    "Email": "csstrand@strandvision.com",
    "NickName": "string",
    "Phone": "string",
    "Web": "string",
    "Photo": "https://strandvision.com/.?ImageDB=LG4FX874KHC52OFCA7RXL",
    "Gender": "Female",
    "Dept": "Quality Assurance",
    "Title": "Quality Assurance Manager",
    "Skip": "Birthdays"
  }
}
Response examples (200) 
{
  "Id": 1234,
  "Emp_Id": 1001,
  "Created": "Thu, 21 Aug 2014 15:43:00 GMT",
  "Deleted": 0,
  "Parent": 10028,
  "Custno": 10028,
  "DispGroup": "Menomonie, WI (10)",
  "Source_Id": 1001,
  "Location": "Menomonie",
  "Email": "mjstrand@strandvision.com",
  "FirstName": "Mike",
  "LastName": "Strand",
  "NickName": "",
  "Phone": "",
  "Web": "",
  "Photo": "https://strandvision.com/.?ImageDB=PF4FX87QKHC52OFCA7RXL",
  "Gender": "Male",
  "Dept": "Administration",
  "Title": "President & CEO",
  "Birthday": "Sat, 01 Aug 2037 01:02:03 GMT",
  "HireDate": "Thu, 02 Aug 2029 01:02:03 GMT",
  "TermDate": "",
  "Skip": "Birthdays",
  "DateLast": "Fri, 04 Aug 2023 14:25:00 GMT",
  "DateEdit": "Thu, 21 Aug 2014 15:43:00 GMT"
}
Response examples (200) 
{
  "Id": 1016,
  "Emp_Id": 1016,
  "Created": "Thu, 21 Aug 2014 15:43:00 GMT",
  "Deleted": 0,
  "Parent": 10028,
  "Custno": 10028,
  "DispGroup": "Menomonie, WI (10)",
  "Source_Id": 1016,
  "Location": "Washington",
  "Email": "csstrand@strandvision.com",
  "FirstName": "Ingred",
  "LastName": "Bergman",
  "NickName": "string",
  "Phone": "string",
  "Web": "string",
  "Photo": "https://strandvision.com/.?ImageDB=LG4FX874KHC52OFCA7RXL",
  "Gender": "Female",
  "Dept": "Quality Assurance",
  "Title": "Quality Assurance Manager",
  "Birthday": "Sun, 09 Aug 2037 01:02:03 GMT",
  "HireDate": "Mon, 10 Aug 2015 01:02:03 GMT",
  "TermDate": 0,
  "Skip": "Birthdays",
  "DateLast": "Fri, 21 Jul 2023 22:52:00 GMT",
  "DateEdit": "Thu, 21 Aug 2014 15:43:00 GMT"
}