Here's a summary of changes made as part of our May 2024 release:
1. API Enhancements
We launched several new API endpoints that you can use to manage your workflows via API. This feature includes:
- Creating a New Order: POST /orders: This endpoint, renamed from /order to /orders, allows you to create a new order.
- Getting Order Details: GET /orders/{orderId}: This new endpoint returns the order ID, status, and details of the order items, including their status and tracking URL.
- Getting Catalog Details: Availability: GET /catalog now includes an availability field listing the countries where a product is available.
- Filtering: You can now filter the catalog by SKU IDs (a list of IDs can be passed as a parameter, useful for retrieving only the SKUs from a package).
- Getting Package Information: The improved Package endpoint now includes the SKU IDs of assets in a package and the users assigned to it.
Swagger documentation here includes additional details. You can also read more here on the use cases supported by these new endpoints.
2. ADP Integration
We launched the ability to onboard, update and offboard users when they are onboarded, updated or offboarded in ADP.
There's four workflows supported:
- Onboard User with Package - This workflow focuses on creating new users in Firstbase once they are created in ADP and automatically assigns each user the right equipment package.
- Onboard User without Package - This workflow focuses on creating new users in Firstbase once they are created as new hires in ADP, but does not assign a package automatically to the user.
- Offboard User - This workflow will automatically start the offboarding process for users in Firstbase, when they are marked as terminated in ADP.
- Updating User - The ADP - Update integration will update a user's details (e.g. address, personal email) in Firstbase when they are updated in ADP.
More details on the Firstbase - ADP Integration can be found here.