Lovable: Connect Your App to Deel

LovableView original changelog

Lovable added a Deel connector that lets apps read and update a company's contracts, people, timesheets and time off, and read its payments. It is an app + chat connector, so one shared connection works in Chats, in the project chat and in published apps. It targets internal tools such as team directories, timesheet approval queues and payroll reports.

Key Takeaways

  • Deel is now an app + chat connector, so one shared connection works in Chats, the project chat and published apps.
  • Apps can read and update contracts, people, timesheets and time off, and read payments and their breakdowns.
  • Apps can approve or reject timesheets and invoice adjustments, enabling approval queues that send decisions back to Deel.
  • Deel webhooks let an app react to events such as a new contract or a submitted timesheet.
  • Connections use a Deel organization API token, with a Sandbox environment for safely testing write flows before touching real payroll data.
  • Because the token covers the whole organization, Lovable recommends requiring sign-in so each person only sees their own records.

Deel joins Lovable's app + chat connectors

Lovable added a connector for Deel, the global payroll and HR platform used to hire and pay employees and contractors in other countries. The connector lets a Lovable app work with a company's Deel data, and it is aimed at internal tools built by HR, finance and operations teams.

Deel is an app + chat connector. That means a single shared connection works in Chats, in the project chat while an app is being built, and inside published apps. It can be added from Connectors, or by asking Lovable in a project to connect it.

What an app can do with Deel

With the connector, an app can list contracts and people along with their departments, teams and organization structure. It can log hours on contractor timesheets, and approve or reject timesheets and invoice adjustments. It can read time-off requests and balances, and create or review requests. It can also read payments and their breakdowns, and react when Deel reports a change, such as a new contract or a submitted timesheet.

Lovable's documentation suggests example builds including a team directory, a contractor timesheet portal, a timesheet approval queue, a time-off calendar, a payroll cost report grouped by country and currency, and a new-hire onboarding checklist that starts when a contract is created in Deel.

Setting it up

Connecting Deel needs a Deel account with access to More > Developer, a Deel organization API token, and permission to create connections in the Lovable workspace. The token is created under the Access Tokens tab by choosing Organization token, then selecting the scopes the app needs, for example contracts:read, people:read, timesheets:write and time-off:read. Adding webhooks:write lets Deel notify the app about changes. Lovable does not check scopes at connection time, so a call without the right scope is rejected by Deel with the missing scope named.

When creating the connection, users pick an environment, Production or Sandbox, paste the token, and choose who can use the connection. Lovable verifies the token against the Deel API before saving. Multiple Deel connections can exist, for example one for sandbox and one for production.

Safety notes

Because an organization token acts for the whole Deel organization, every app linked to the connection can reach all data the scopes allow. For apps used by employees or contractors, Lovable advises asking it to sign people in and show each person only their own records. Without sign-in, anyone who opens the app could read contracts and payroll data. Writes on a production connection change real contracts, timesheets and payroll, so Lovable recommends building and testing write flows against a Deel sandbox connection first. Billing is handled directly by Deel.