deel_skill

Overview

This skill integrates with Deel to manage HRIS data, records, and workflows for international teams. It leverages Membrane to handle authentication and provide pre-built actions and a proxy to the Deel API. Use it to query people, contracts, invoices, timesheets, and time-off events without handling tokens directly.

How this skill works

The skill runs Membrane actions and proxy requests against the Deel connector. Membrane manages authentication, token refresh, pagination, and common error handling so actions can focus on input parameters and results. You can list available actions, run them with JSON inputs, or fall back to the proxy for endpoints not covered by pre-built actions.

When to use it

• Sync or query worker and contract data (people, contracts, legal entities).
• Retrieve financial or billing records such as invoices and invoice adjustments.
• Manage timesheets, milestones, and time-off events for contractors or employees.
• Perform one-off or custom API calls via Membrane proxy when actions do not exist.
• Avoid handling raw API keys or OAuth flows in your integration code.

Best practices

• Prefer Membrane pre-built actions for common tasks to get built-in pagination and mapping.
• Run action discovery (membrane action list) before creating custom requests.
• Create and reuse connections rather than prompting users for credentials.
• Use the proxy for unsupported endpoints but keep requests minimal and paginated.
• Pass structured JSON input to actions and validate required fields before running.

Example use cases

• List all active contractors and export contact details for payroll processing.
• Retrieve timesheets for a contract to calculate payment for a billing cycle.
• Create a contract milestone tied to a payment schedule for a contractor.
• Fetch paid invoices to reconcile with your accounting system.
• Update a worker’s department or profile information in bulk.