Skip to main content

Sync additional employee data

Answered

Comments

6 comments

  • Official comment
    Ann Murphy

    Hello 7shifts Developers!

    Employee phone numbers and addresses are currently not available in any of our APIs.

    Regarding Employee Punch ID, can you please clarify what data you are looking for? Do you mean the employee Toast POS passcode?

    An Employee ID field is available as the externalEmployeeID, which is an external identifier that can be defined by the restaurant or integration partner. This field is found in the employee endpoint of the Labor API (see attached screenshots). Details can be found in the Toast Labor API Developer’s Guide.

    Can you provide additional information about the workflow you are trying to accomplish? We can look into alternate solutions. I've also let our product team know you're interested in seeing this information, and we'll let you know if this changes in the future.

    externalEmployeeID in Employees endpoint:

    Corresponding field in Toast Web:

  • 7shifts Developers

    Thanks for your response.

    Additional information on the workflow we are trying to accomplish:

    • Our Toast integrated customers currently have to update many employee data fields in both Toast and 7shifts. We can save the customer time and effort by syncing more fields automatically.
    • We would like to make our Employee Sync feature more valuable to our customers by bringing in more employee data that has already been inputted in Toast
    • The goal is to reduce and eventually eliminate the need for double entry between our two platforms
    • We have over 25 pieces of customer feedback requesting phone numbers to be added in 7shifts as part of Employee Sync
    • We also get frequent feedback about syncing other fields such as Address, Punch ID, etc.
    • To clarify, Punch ID will be the unique number that each employee uses to punch in/out from their shift - appears to be 'Passcode' in Toast
    0
  • Ann Murphy

    Thank you for the background information.

    I will let our development team know your feedback regarding phone numbers and the volume of requests you have received.

    Employee addresses are not collected in the Toast Web POS backend. Restaurants can capture detailed employee information in the Toast Payroll & Team Management module, whose data is not exposed via API.

    Punch IDs (i.e., passcodes) are treated like passwords at Toast and for security purposes, are not retrievable through our APIs. There is no plan to expose this data via API. While you cannot retrieve passcodes, you can update existing employee passcodes or create passcodes for new employees using the /employees endpoint of the Labor API. This would allow 7shifts to be the source of truth for passcodes and will allow passcodes to sync from 7shifts to Toast.

    0
  • 7shifts Developers

    Great, thank you for your responses!

    0
  • 7shifts Developers

    Hi Ann, has there been any consideration into making phone numbers available through the API?

    0
  • Ann Murphy

    Hello 7shifts Developers! There are no updates on this request at this time. 

    0

Please sign in to leave a comment.