---
title: "Kafka Listener"
slug: "kafka-listener"
updated: 2024-09-03T13:30:37Z
published: 2024-09-03T13:30:37Z
canonical: "help.csgi.com/kafka-listener"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.csgi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kafka Listener

## Creating a Kafka Listen Adaptor

The **Kafka Listen Adaptor** allows a Graph to respond to new messages as they are published to a Kafka Topic.

In order to create a **Kafka Listen Adaptor**, you must first create a [Kafka Connection](/v1/docs/kafka-connection).

![](https://cdn.document360.io/c578bb14-e570-4b6e-93ed-f6c5b8a2d8a1/Images/Documentation/Snagit%20Listener.png?sv=2026-02-06&spr=https&st=2026-10-26T14%3A18%3A45Z&se=2026-10-26T15%3A18%3A45Z&sr=c&sp=r&sig=BD%2FlYX1EFHG%2F3WX2N1gfxe%2BQ0qc55hg1ud8Biw8252I%3D)

To create the Kafka Listen to Adaptor on any graph, click on the “**Graph Options**” button in the top left-hand side of the Graph Editor, then select “**Add Listene**r”.

![](https://cdn.document360.io/c578bb14-e570-4b6e-93ed-f6c5b8a2d8a1/Images/Documentation/Graph%20Options.png?sv=2026-02-06&spr=https&st=2026-10-26T14%3A18%3A45Z&se=2026-10-26T15%3A18%3A45Z&sr=c&sp=r&sig=BD%2FlYX1EFHG%2F3WX2N1gfxe%2BQ0qc55hg1ud8Biw8252I%3D)

This will direct you to the “**Listener Edito**r” modal. Select the Kafka listener type from the “**Listener Type”** dropdown.

- Select a connection from the “Connection” dropdown.

The “Number of Consumers” is configurable, but each Kafka Broker can only have one active Consumer per Topic.

> **For Example**:
> 
> If a Kafka Cluster has a Topic shared across 3 Brokers, only 3 Kafka Consumers will be active, even if “Number of Consumers” is set to 5.

Messages the Kafka Listener receives will be returned to the Records Selected output destination in JSON serialized format.

---

## Validation Warnings

New Notification : All the warning notifications will be displayed in the **Notification Panel** at the right side of the page.

| Notification | Note |
| --- | --- |
| Kafka Listener must have an output. | It is necessary to select an output location for the Kafka Adaptor. |
| Kafka Listener must have a connection set. | No connection has been selected. |

---

### Related Pages:

- [Kafka Write Adaptor](/v1/docs/kafka-write-adaptor)