Team API Overview
The Team API automates team member management. Management functions include creating new team members, updating team member properties, assigning wage settings, and deactivating team members. Team members can be scheduled in appointments, assigned to a Labor API shift, and paid through the Seller Dashboard payroll feature.
Team members created and updated with the Team API are available in the Seller Dashboard under the following items:
Team. The new team member is shown in the Team Members list.
Use the Seller Dashboard to assign a passcode and permissions to new team members.
Timecards. The new team member is shown in the New Shift window in the Name list.
Appointments. The new team member is shown in the Staff list.
Cash drawer shifts. A team member can be assigned to a cash drawer shift.
Payroll. The new team member is not automatically added to the seller's payroll. However, the seller can now select the team member to be added to the payroll.
Team members cannot be created in the Sandbox Seller Dashboard.
Team member permissions cannot be assigned via a Square API. They must be set in the Team application in the Seller Dashboard.
A webhook is a subscription that notifies you when a Square event occurs. For more information about using webhooks, see Square Webhooks Overview.
The Team API uses the following webhook events:
Event | Permission | Description |
---|---|---|
team_member.created | EMPLOYEES_READ | A new team member was created. |
team_member.updated | EMPLOYEES_READ | A team member was updated. |
team_member.wage_setting.updated | EMPLOYEES_READ | A new team member wage setting was updated. |
For a complete list of webhook events, see V2 Webhook Events Reference.
If you need more assistance, contact Developer Support or ask for help in the Developer Forums.