# Move Contract Stage — fynk

> Move a contract forward in Fynk's lifecycle. See documentation pages move document to review stage and move document to signing stage.

- Key: `fynk-move-contract-stage`
- Type: Action (Write)
- Version: 0.0.1
- App: fynk (`fynk`) — https://pipedream.com/apps/fynk.md
- This page (HTML): https://pipedream.com/apps/fynk/actions/move-contract-stage
- Hints: destructive · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/fynk/actions/move-contract-stage/move-contract-stage.mjs

## Description

Move a contract forward in Fynk's lifecycle. See documentation pages [move document to review stage](https://app.fynk.com/v1/docs#/operations/v1.documents.stage-transitions.review) and [move document to signing stage](https://app.fynk.com/v1/docs#/operations/v1.documents.stage-transitions.signing).

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `documentUuid` | `string` | Yes | The document to operate on Options are loaded from the connected account. |
| `targetStage` | `string` | Yes | The stage to move the contract to |
| `signatureType` | `string` | No | The signature type to use when moving to signing stage. Only used when Target Stage is set to signing |
| `sequentialSigning` | `boolean` | No | If true, signatures will be requested in the order defined by the signatories' signing_order. Only used when Target Stage is set to signing |
| `message` | `string` | No | Message to include in the email sent to the document's signatories. This is included in addition to the default email text provided by fynk. Only used when Target Stage is set to signing |

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

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: "fynk-move-contract-stage",
  arguments: {
    documentUuid: "Document",
    targetStage: "Target Stage",
  },
})
```

**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: "fynk-move-contract-stage",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    fynk: { authProvisionId: "apn_xxxxxxx" },
    documentUuid: "Document",
    targetStage: "Target Stage",
  },
})

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": "fynk-move-contract-stage",
    "configured_props": {
      "fynk": { "authProvisionId": "apn_xxxxxxx" },
      "documentUuid": "Document",
      "targetStage": "Target Stage"
    }
  }'
```

---

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