> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# eventListenerJob

> Reference for the eventListenerJob workflow task, which

On-prem only

The `eventListenerJob` task pauses a workflow and waits for an event that matches a specified topic and schema. Job variables can also be used with this task.

## Potential use case

Suppose you have an email queue that requires all relevant information in a form to be filled out. The `eventListenerJob` task could be used to pause the request if the correct information is not present when the request is passed through.

## Properties

| Incoming | Type   | Required | Description                                            |
| -------- | ------ | :------: | ------------------------------------------------------ |
| `job_id` | String |    Yes   | The job ID.                                            |
| `source` | String |    Yes   | The source that provides the topic.                    |
| `topic`  | String |    Yes   | The event topic.                                       |
| `schema` | Object |    Yes   | A valid JSON schema that uniquely identifies an event. |

| Outgoing | Type   | Description                        |
| -------- | ------ | ---------------------------------- |
| `result` | Object | The payload of the captured event. |

## Example

In this example:

* The `source` string refers to `@itential/app-workflow_engine` to pull job information.
* The event `topic` is `jobPause`. The job completes once it is paused on the Jobs page, where the `result` is shown.
* The `schema` from the `source` being listened for is `{"type":"object","required":["job"],"properties":{"job":{}}}`.

![](/_fern-img/ecb3f27a842e95e0745f917e81ee4f63cb0874b5ec78a73cb7bd666dfe04192f.webp)

The `result` returns information relevant to the workflow — specifically the job `_id`, name, type, and tasks.

![](/_fern-img/b9bab7a8cc5bcc6cb698ef8dc086b2c0b31421c71750cc8be30c76211f13a22a.webp)