# New Change in Envelope Status — Docusign

> Emit new event when an envelope's status is updated

- Key: `docusign-new-change-in-envelope-status`
- Type: Trigger (Polling)
- Version: 0.0.3
- App: Docusign (`docusign`) — https://pipedream.com/apps/docusign.md
- This page (HTML): https://pipedream.com/apps/docusign/triggers/new-change-in-envelope-status
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/docusign/sources/new-change-in-envelope-status/new-change-in-envelope-status.mjs

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `account` | `string` | No | 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). Options are loaded from the connected account. |
| `timer` | `$.interface.timer` | Yes | Pipedream will poll the Docusign API on this schedule |
| `status` | `string[]` | Yes | Watch for envelopes that have been updated to the selected statuses |

## Returns

Events emitted by Docusign.

## Run it

**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 deployed = await pd.triggers.deploy({
  id: "docusign-new-change-in-envelope-status",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    docusign: { authProvisionId: "apn_xxxxxxx" },
    account: "Account",
    timer: { "intervalSeconds": 900 },
  },
  webhookUrl: "https://example.com/webhooks/docusign",
})

console.log(deployed.id)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/triggers/deploy \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "docusign-new-change-in-envelope-status",
    "webhook_url": "https://example.com/webhooks/docusign",
    "configured_props": {
      "docusign": { "authProvisionId": "apn_xxxxxxx" },
      "account": "Account",
      "timer": { "intervalSeconds": 900 }
    }
  }'
```

**MCP**

MCP servers expose Docusign actions as on-demand tools.

New Change in Envelope Status is an event source, so your application deploys it with the Connect SDK or API and then either receives each event at a webhook URL or retrieves events on demand with the trigger events API.

## Event delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source. Or: no webhook required — your app or agent can fetch recent events from the [trigger events API](https://pipedream.com/docs/connect/api-reference/list-trigger-events.md) instead.

---

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