# Create Application — Ashby

> Considers a candidate for a job (e.g., when sourcing a candidate for a job posting). See the documentation

- Key: `ashby-create-application`
- Type: Action (Write)
- Version: 0.0.4
- App: Ashby (`ashby`) — https://pipedream.com/apps/ashby.md
- This page (HTML): https://pipedream.com/apps/ashby/actions/create-application
- Hints: open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/ashby/actions/create-application/create-application.mjs

## Description

Considers a candidate for a job (e.g., when sourcing a candidate for a job posting). [See the documentation](https://developers.ashbyhq.com/reference/applicationcreate)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `candidateId` | `string` | Yes | The ID of the candidate to create an application for Options are loaded from the connected account. |
| `jobId` | `string` | Yes | The ID of the job to apply for Options are loaded from the connected account. |
| `interviewPlanId` | `string` | No | The ID of the interview plan to place the application in. If none is provided, the default interview plan is used. Options are loaded from the connected account. |
| `interviewStageId` | `string` | No | The interview stage of the interview plan to place the application in. If none is provided, the application is placed in the first 'Lead' stage. You can also use the special string 'FirstPreInterviewScreen' to choose the first pre-interview-screen stage. Options are loaded from the connected account. |
| `sourceId` | `string` | No | The source to set on the application being created Options are loaded from the connected account. |
| `creditedToUserId` | `string` | No | The ID of the user the application will be credited to Options are loaded from the connected account. |
| `createdAt` | `string` | No | An ISO date string to set the application's createdAt timestamp (e.g., 2024-01-15T10:30:00Z). Defaults to the current time if not provided. |

## 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": "ashby",
      },
    },
  },
)

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: "ashby-create-application",
  arguments: {
    candidateId: "Candidate ID",
    jobId: "Job ID",
  },
})
```

**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: "ashby-create-application",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    ashby: { authProvisionId: "apn_xxxxxxx" },
    candidateId: "Candidate ID",
    jobId: "Job ID",
  },
})

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": "ashby-create-application",
    "configured_props": {
      "ashby": { "authProvisionId": "apn_xxxxxxx" },
      "candidateId": "Candidate ID",
      "jobId": "Job ID"
    }
  }'
```

---

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