# How to launch a new request with context parameters from an external application via the web service API using SOAP

**URL:** <https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-the-web-service-api-using-soap/327>\
**Category:** Web API\
**Created:** [October 8, 2015, 7:57am UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-the-web-service-api-using-soap/327 "2015-10-08T07:57:39Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![wfg-admin](https://yyz2.discourse-cdn.com/flex030/user_avatar/discuss.workflowgen.com/wfg-admin/32/714_2.png) [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)\
**Post date:** [October 8, 2015, 7:57am UTC](https://discuss.workflowgen.com/t/how-to-launch-a-new-request-with-context-parameters-from-an-external-application-via-the-web-service-api-using-soap/327/1 "2015-10-08T07:57:39Z")

</div>

This procedure lets you launch a new process from another application using HTTP parameters. It applies to WorkflowGen versions 5 and 6. Follow the instructions below for your version of WorkflowGen.

**Note:** For security reasons, the impersonation feature is restricted to allowed users, as defined in the `ProcessesRuntimeWebServiceAllowedUsers` entry in the `\wfgen\ws\web.config` (version 5) or `\wfgen\web.config` (versions 6 and later) file.

### **WorkflowGen versions 6 and later**

Via WS API: `StartProcess`

**Method definition**

- `public int StartProcess(string processName, bool test, string context)`: Returns the created request ID if successful

**Required parameters**

- `processName`

- `test`

- `context`

**Optional parameters (`StartProcessHeader`)**

- `ImpersonateUsername`

- `ProcessId`

- `ProcessVersion`

Download [SDK\_CS\_RemoteLaunchSOAP\_v6\_1.zip](https://app.box.com/s/mqtdihsyjfdrwokqxqhjppbzpx7b3t10), unzip it, and follow the instructions in the included `setup.txt` file for an example of usage.

### WorkflowGen version 5

Via WS API: `StartProcess`

**Method definition**

- `public int StartProcess(string processName, bool test, string context)`: Returns the created request ID if successful

**Required parameters**

- `processName`

- `test`

- context

**Optional parameter (`StartProcessHeader`)**

- `ImpersonateUsername`

Download [SDK\_CS\_RemoteLaunchSOAP\_v5.zip](https://app.box.com/s/qm0o3qdni945mx5vf504ntf5nqeizzu3), unzip it, and follow the instructions in the included `setup.txt` file for an example of usage.