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

# Ometria

> Let the Dema Agent read contacts, orders, products, and segments from Ometria, push records, and send transactional emails when you ask.

## Overview

Once Ometria is connected, the Dema Agent can work with your Ometria data directly inside a conversation — read contacts, orders, products, and segments, push records into Ometria, and send transactional emails.

The agent only acts when you ask it to, and Dema asks you to confirm sensitive changes before they are applied.

***

## Prerequisites

* An Ometria account with **administrator** permissions — only admins can open the API keys page.

<Note>
  Ometria has two different APIs. Dema uses the **Data API** (the key created under **Settings → API keys**). Do not use a **Query API** key from "Query API Access" — it authenticates differently and will not work here.
</Note>

***

## Connect Ometria

<Steps>
  <Step title="Create an API key in Ometria">
    1. In Ometria, go to **Settings**.
    2. Open the **API keys** tab.
    3. Click **Add new API key**.
    4. Give it a unique title you will recognize, such as `Dema Agent`.
    5. Save the key, click the **eye icon** to reveal it, and copy it.

    <Note>
      A new key can take up to **10 minutes** to become active. If the agent cannot authenticate right after you create the key, wait a few minutes and try again.
    </Note>
  </Step>

  <Step title="Connect in Dema">
    In Dema, go to **Agents → Settings → Integrations**, find **Ometria**, and click **Connect**. Enter:

    * **API key** — the key you copied from Ometria.

    Click **Add**. Dema marks the integration as Active.
  </Step>
</Steps>

A single Data API key covers everything the agent does — reading data, pushing records, and sending transactional emails. You do not need separate keys for read and write.

***

## Rotating the key

Ometria keys do not have a rename or regenerate option. To rotate, create a new key under **Settings → API keys**, click **Reconnect** on the Ometria integration card in Dema, enter the new key, then revoke the old key in Ometria.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Dema cannot authenticate">
    Check that you copied the full key from **Settings → API keys** (the **Data API** key, not a Query API key). Also wait up to 10 minutes after creating a key — new keys take a short while to activate.
  </Accordion>

  <Accordion title="I cannot find the API keys tab">
    The API keys page is only available to **administrators**. Ask an admin on your Ometria account to create the key, or to grant you admin access.
  </Accordion>

  <Accordion title="The agent's Ometria requests are failing">
    Confirm the key has not been revoked in Ometria. If it has, create a new key and click **Reconnect** in Dema.
  </Accordion>
</AccordionGroup>

If you are still stuck, contact [support](mailto:info@dema.ai) with the error message you see.

***

## Additional resources

* [Ometria API keys](https://support.ometria.com/hc/en-gb/articles/360012199857-API-keys)
* [Creating a new API key](https://support.ometria.com/hc/en-gb/articles/9882706389917-Creating-a-new-API-key)
* [Ometria Data API introduction](https://docs.ometria.com/docs/ometria-data-api-introduction)