Variables | Docusign | Documentation

A workflow variable holds a piece of data used by the workflow steps. Variables can be either:

Starting variables, defined in your workflow settings and assigned values before an instance of that workflow is created in a special form called a trigger form. You can create starting variables when you select the start method for a workflow. See Workflow start methods for details.

In addition to assigning values to starting variables through a trigger form, you can pass in values through the trigger URL when you start your workflow.

This is typically used when workflows are initiated in an external system, such as a bank website. For example, when the workflow is triggered, you can provide a set of account info with the trigger URL to populate starting variables such as name and email in the webform automatically for the participant. In this case, you would create starting variables for each of the expected values coming from the external system so that, when triggering the workflow, you can map them to fields used in a step, such as a web form.

Example syntax (method, endpoint and JSON):
```
POST <trigger-url>
{
  participants: {},
  instanceName: 'Name your instance', // Optional
  payload: {
    startingVariableName1: 'Value',
    startingVariableName2: 'Value2'
  },
  metadata: {}
}
```
Step variables, which are defined and populated by the steps in your workflow.

See Workflows for a full workflow definition example, including variable data.