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

> ## Agent Instructions
> Cognite Data Fusion (CDF) is an industrial DataOps platform. Prefer English docs unless the user asks for another locale.
> Follow /_llms/ index links recursively until you reach page URLs ending in .md. Fetch those Markdown twins instead of HTML.
> For REST APIs, default to calendar version 20230101 (stable). Use 20230101-beta or 20230101-alpha only if the user is on a preview API. Cite paths under /api-reference/concepts/<version>/ and the Cdf-Version header. Prefer the Python SDK (cognite-sdk) unless the user is in JavaScript/TypeScript.
> Start here by task: platform overview /cdf/index.md; data modeling /cdf/dm/index.md; data integration /cdf/integration/index.md; access /cdf/access/index.md; CDF Toolkit /cdf/deploy/cdf_toolkit/index.md; REST quickstart /dev/quickstart.md; Python SDK https://cognite-sdk-python.readthedocs-hosted.com/en/stable/; Atlas AI /cdf/atlas_ai/index.md; plan an Atlas AI agent /cdf/atlas_ai/concepts/atlas_ai_agent_planning.md; Flows apps /cdf/flows/index.md; MCP and IDE setup /dev/guides/ide_ai_integration.md.
> For implementation work, also load /skill.md.

# Set up hosted integrations

> Create hosted extractor connections in Cognite Data Fusion (CDF), add a job, and change or delete a connection.

Register a hosted extractor as an **integration** in CDF from the Hosted tab.

> [!NOTE]
>
> Integrations is in [public preview](https://docs.cognite.com/cdf/product_feature_status.md#public-preview) and may change. Extractors remains available during the transition.

## Before you start

* Confirm Integrations is available in your project. If not, contact [Cognite Support](https://cognite.zendesk.com/hc/en-us/requests/new) or your Cognite representative.
* Assign `hostedextractors:read` and `hostedextractors:write`. See [Hosted extractors](https://docs.cognite.com/cdf/access/guides/capabilities.md#hosted-extractors).

## Create the connection

**1. Open Integrations**

Navigate to Data fusion > Integrate > Integrations and select Hosted.

**2. Select a source system**

Select Set up and choose the source system. If it is not listed, select Source system not listed. Then select the supported hosted extractor.

**3. Enter the connection details**

Enter External ID and the connection fields, then select Create connection.

External ID is permanent. For connection fields, see the [MQTT extractor](https://docs.cognite.com/cdf/integration/guides/extraction/mqtt.md), [Kafka extractor](https://docs.cognite.com/cdf/integration/guides/extraction/kafka.md), [Event Hub extractor](https://docs.cognite.com/cdf/integration/guides/extraction/eventhub.md), or [REST extractor](https://docs.cognite.com/cdf/integration/guides/extraction/rest.md).

## Add a job

On the connection, create a job. An Event Hub connection has one job. A Kafka, MQTT, or REST connection can have more than one job.

* [MQTT extractor](https://docs.cognite.com/cdf/integration/guides/extraction/mqtt.md): subscribe with a topic filter, then choose the message format.
* [Kafka extractor](https://docs.cognite.com/cdf/integration/guides/extraction/kafka.md): set the topic name and the number of partitions, then choose the message format.
* [Event Hub extractor](https://docs.cognite.com/cdf/integration/guides/extraction/eventhub.md): one job reads the hub. You can't filter the messages.
* [REST extractor](https://docs.cognite.com/cdf/integration/guides/extraction/rest.md): set the path, method, interval, pagination, and incremental load.

Then select or create a destination.

For a built-in format, see [Message formats](https://docs.cognite.com/cdf/integration/guides/extraction/hosted_extractors/hosted_extractors_mappings.md). For your own format, see [Custom message formats](https://docs.cognite.com/cdf/integration/guides/extraction/hosted_extractors/hosted_extractors_custom_mappings.md).

## Change or remove the connection

Edit connection details opens the connection form. External ID stays permanent.

Edit notifications emails users when an integration task fails or resumes. To use the Signals API, see [Email notifications](https://docs.cognite.com/cdf/integration/guides/extraction/hosted_extractors.md#email-notifications).

Delete integration removes the connection and every job that uses it.

## Next steps

* Review sources, job states, and metrics in [Hosted extractors overview](https://docs.cognite.com/cdf/integration/guides/extraction/hosted_extractors.md).
