fynk ACTION
Move Contract Stage
Move a contract forward in Fynk's lifecycle. See documentation pages move document to review stage and move document to signing stage.
- Action
- Writes data
- Destructive
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's fynk account once, then configure and run Move Contract Stage from your backend or agent.
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 -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"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{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",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
documentUuid Document | string | The document to operate on Required Dynamic |
targetStage Target Stage | string | The stage to move the contract to Required |
signatureType Signature Type | string | The signature type to use when moving to signing stage. Only used when Target Stage is set to signing Optional |
sequentialSigning Sequential Signing | boolean | If true, signatures will be requested in the order defined by the signatories' signing_order. Only used when Target Stage is set to signing Optional |
message Message | string | 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 Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- fynk-move-contract-stage
- Version
- 0.0.1
- App
- fynk
- Authentication
- API key
- Read-only
- No
- Destructive
- Yes
- Open world
- Yes
- Source
- View on GitHub ↗