# Create IC Contract — Deel

> Create a new independent contractor (IC) contract in Deel. Use this to hire a contractor with a fixed rate, pay-as-you-go, or milestone-based arrangement. type must be one of: ongoing_time_based (recurring fixed rate), payg_tasks…

- Key: `deel-create-ic-contract`
- Type: Action (Write)
- Version: 0.0.2
- App: Deel (`deel`) — https://pipedream.com/apps/deel.md
- This page (HTML): https://pipedream.com/apps/deel/actions/create-ic-contract
- Hints: open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/deel/actions/create-ic-contract/create-ic-contract.mjs

## Description

Create a new independent contractor (IC) contract in Deel. Use this to hire a contractor with a fixed rate, pay-as-you-go, or milestone-based arrangement. `type` must be one of: `ongoing_time_based` (recurring fixed rate), `payg_tasks` (per-task), `payg_milestones` (milestones), `pay_as_you_go_time_based` (hourly/daily pay-as-you-go). `compensationScale` must be one of: `hourly`, `daily`, `weekly`, `monthly`, `biweekly`, `semimonthly`, `custom`. `compensationFrequency` must be one of: `weekly`, `biweekly`, `semimonthly`, `monthly`. `clientTeamId` and `clientLegalEntityId` are required — ask the user to provide these from their Deel organization settings. [See the documentation](https://developer.deel.com/api/reference/endpoints/contracts/create-ic-contract)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `title` | `string` | Yes | A descriptive title for this contract (e.g., Strategy Consulting). |
| `type` | `string` | Yes | Contract type. One of: ongoing_time_based, payg_tasks, payg_milestones, pay_as_you_go_time_based. |
| `startDate` | `string` | Yes | Contract start date in ISO 8601 format (e.g., 2026-09-01). |
| `clientTeamId` | `string` | Yes | The ID of the client team (department) for this contract. Retrieve from your Deel organization settings. |
| `clientLegalEntityId` | `string` | Yes | The ID of the client legal entity (company) for this contract. Retrieve from your Deel organization settings. |
| `jobTitle` | `string` | Yes | The contractor's job title (e.g., Software Engineer, Marketing Consultant). |
| `compensationAmount` | `string` | No | The compensation amount (e.g., 4000). Not required for payg_tasks contracts. |
| `compensationCurrencyCode` | `string` | Yes | ISO 4217 currency code (e.g., USD, EUR, GBP). |
| `compensationScale` | `string` | No | How the rate is measured. One of: hourly, daily, weekly, monthly, biweekly, semimonthly, custom. Not required for task-based contracts. |
| `compensationFrequency` | `string` | Yes | How often the contractor is paid. One of: weekly, biweekly, semimonthly, monthly. |
| `cycleEnd` | `integer` | Yes | Day of month the pay cycle ends (e.g., 28). Required by Deel. |
| `cycleEndType` | `string` | Yes | How cycle end is calculated. Use DAY_OF_MONTH. |
| `paymentDueDays` | `integer` | Yes | Number of days after cycle end that payment is due (e.g., 5). |
| `paymentDueType` | `string` | Yes | How payment due date is calculated. Use AFTER_MONTH. |
| `workerFirstName` | `string` | Yes | The contractor's first name. |
| `workerLastName` | `string` | Yes | The contractor's last name. |
| `workerEmail` | `string` | Yes | The contractor's email address. |
| `scopeOfWork` | `string` | No | Description of the work to be performed. |
| `documentsRequired` | `boolean` | No | Whether additional documents are required before contract activation. Defaults to false. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "deel",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "deel-create-ic-contract",
  arguments: {
    title: "Contract Title",
    type: "Contract Type",
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "deel-create-ic-contract",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    deel: { authProvisionId: "apn_xxxxxxx" },
    title: "Contract Title",
    type: "Contract Type",
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "deel-create-ic-contract",
    "configured_props": {
      "deel": { "authProvisionId": "apn_xxxxxxx" },
      "title": "Contract Title",
      "type": "Contract Type"
    }
  }'
```

---

- App: https://pipedream.com/apps/deel.md · All apps: https://pipedream.com/apps