Docusign ACTION
List Envelopes
Search for DocuSign envelopes by date, status, email, text, or folder filters. Use this to find envelope IDs for Get Envelope, List Recipients, List Documents, Send Envelope, Void Envelope, or Create Recipient View. See the documentation
- Action
- Read only
- OAuth
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Docusign account once, then configure and run List Envelopes 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: "docusign-list-envelopes",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
docusign: { authProvisionId: "apn_xxxxxxx" },
account: "Account",
fromDate: "From Date",
},
})
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": "docusign-list-envelopes",
"configured_props": {
"docusign": { "authProvisionId": "apn_xxxxxxx" },
"account": "Account",
"fromDate": "From Date"
}
}'// 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": "docusign",
},
},
},
)
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: "docusign-list-envelopes",
arguments: {
account: "Account",
fromDate: "From Date",
},
})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 |
|---|---|---|
account Account | string | Your DocuSign account. Leave blank to automatically use your default account, or provide an Account ID (you can use List Accounts to retrieve available accounts). Optional Dynamic |
fromDate From Date | string | Return envelopes changed on or after this ISO 8601 datetime, for example 2026-04-01T00:00:00Z. Defaults to 30 days ago. Optional |
toDate To Date | string | Return envelopes changed on or before this ISO 8601 datetime, for example 2026-04-30T23:59:59Z. Optional |
status Status | string[] | Envelope statuses to include. Optional |
email Email | string | Filter by recipient or sender email address. Optional |
searchText Search Text | string | Search text matched against envelope metadata. Optional |
folderIds Folder IDs | string[] | Filter by one or more folder IDs. Optional Dynamic |
count Count | integer | Number of envelopes to request per page. Optional |
startPosition Start Position | integer | Zero-based result offset for the first page. Optional |
order Order | string | Sort order. Optional |
orderBy Order By | string | Field to sort by. Optional |
fetchAll Fetch All Pages | boolean | When enabled, follow pagination until no pages remain or Max Pages is reached. Optional |
maxPages Max Pages | integer | Maximum pages to retrieve when Fetch All Pages is enabled. 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
- docusign-list-envelopes
- Version
- 0.0.3
- App
- Docusign
- Authentication
- OAuth
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗