KBAISE/ for lovable
Library
Docs

Connect your app to Deel

about 10 minBuildingchecked 5d agoOfficial page
The short version

Connect Deel to your Lovable app using an organization API token to work with contracts, timesheets, time off, and payroll data. Once linked, Lovable can read and update your company records directly.

Teams wanting to build custom internal portals, timesheet submission tools, or employee directories using their Deel HR data.

Do this, in order

  1. 1

    In Deel, navigate to More > Developer > Access Tokens and click Generate new token.

    You need an API token to securely authenticate Lovable with your Deel account.

  2. 2

    Select Organization token, pick the scopes required for your app (such as contracts:read or webhooks:write), click Generate, and copy the token.

    Personal tokens only access your individual account, while organization tokens allow the app to view and manage company data.

  3. 3

    Open Connectors in your Lovable dashboard, select Deel, and click Connect.

    This opens the configuration form where you input your integration details.

  4. 4

    Choose your Environment (Production or Sandbox), paste the Organization API token, set your sharing preferences, and click Connect.

    Lovable validates the token against Deel before saving the connection.

  5. 5

    In your Lovable project chat, ask Lovable to link your Deel connection and build your feature.

    Your project must be linked to the connection before it can make API calls to Deel.

Paste this into your project

Use Deel and build a team directory that shows everyone's role, department, and country. Cache people and departments from Deel so the directory loads quickly without calling Deel on every visit.

Words decoded

Sandbox
A safe testing environment filled with fake sample data so you can build and test without affecting real contracts or payroll.
Scope
A specific permission granted to your API token, controlling exactly what data your app can read or change.
Webhook
An automated message Deel sends to your app whenever an event happens, like a newly created contract.

Where people get stuck

  • Generating a Personal token instead of an Organization token, which prevents the app from accessing company records.
  • Exposing sensitive payroll or contract data to all visitors by failing to add user sign-in to the app.
  • Matching a Sandbox token with a Production environment setting (or vice versa), which causes credentials validation to fail.
  • Forgetting to update webhook subscriptions to point to your live URL after deploying your app from the preview URL.
  • Exceeding Deel's limit of 5 requests per second across your whole organization by not asking Lovable to cache data.

The short version, steps, decoder and prompt on this page are written automatically from Lovable's own documentation and can lag or misread it. The official page is always the authority.