# Test a workflow (/docs/api-reference/workflows/testWorkflow) > Runs the draft once with payload as the trigger data. Every node runs for real: WhatsApp messages, SMS, emails and calls go out and CRM records change. Ask the user before calling it, and use their own phone number or email in the payload. It returns an `execution_id` at once. Poll `getWorkflowExecution` for the result. > **Workflow builder.** Included from the Jump Starter plan. [See plans](https://omnidim.io/pricing). **POST** `/workflows/{workflow_id}/test` Runs the draft once with payload as the trigger data. Every node runs for real: WhatsApp messages, SMS, emails and calls go out and CRM records change. Ask the user before calling it, and use their own phone number or email in the payload. It returns an `execution_id` at once. Poll `getWorkflowExecution` for the result. ```yaml operationId: testWorkflow parameters: - in: path name: workflow_id required: true schema: type: integer description: Id of the workflow. - in: query name: user_id required: false description: | Reseller keys only: the id of one of your direct client users. The call then acts as that client, on that client's agents, numbers, campaigns and balance. Calls, sessions and bulk campaigns spend that client's balance and concurrency. Omit it to act on your own account. An empty value, `0`, `false` or your own user id also means your own account. Any other value that is not a positive integer id is refused with `400 invalid_request`. A key that is not a reseller's gets `403` when it names someone else. A user who is not your direct client gets `404`. schema: type: integer description: | Reseller keys only: the id of one of your direct client users. The call then acts as that client, on that client's agents, numbers, campaigns and balance. Calls, sessions and bulk campaigns spend that client's balance and concurrency. Omit it to act on your own account. Send it as a JSON integer in the body. `null`, `0`, `false` or your own user id also means your own account. Any other value that is not a positive integer id is refused with `400 invalid_request`. A key that is not a reseller's gets `403` when it names someone else. A user who is not your direct client gets `404`. example: 1234 requestBody: required: false content: application/json: schema: type: object properties: payload: type: object additionalProperties: true description: >- The trigger data. Nodes read it as `{{ context.. }}`. See `output_example` of the trigger node type for its shape. responses: '202': description: The run started. content: application/json: schema: type: object properties: execution_id: type: integer '400': description: >- A bad parameter or body. `code` says which, such as `invalid_json`, `invalid_parameter`, `missing_fields` or `no_options`. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: invalid_request error_description: revision is required. Read the workflow to get it. code: missing_fields request_id: req_5d9a1f3e8b02 '401': description: Missing or invalid API key. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: unauthorized error_description: Missing or invalid API key code: invalid_api_key request_id: req_6e2b9d4f1a38 '403': description: | The Workflow Builder is not enabled for this account (`feature_not_enabled`), or your API key's user cannot make this change (`permission_denied`). The Workflow Builder must be included in your plan. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: forbidden error_description: You do not have permission to use Workflows. code: feature_not_enabled request_id: req_9f2c1a4b7d3e '404': description: No workflow, node type or run with that id in your account. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: not_found error_description: No workflow with that id. request_id: req_2c8e7a1d9b40 '409': description: '`no_trigger`: the draft has no trigger node, or `no_draft`.' content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. ``` **curl** ```bash curl -X POST "https://backend.omnidim.io/api/v1/workflows/{workflow_id}/test?user_id=1234" \ -H "Authorization: Bearer $OMNIDIM_API_KEY" ```