---
title: "Taggun integration for LuumenAI"
url: "https://www.luumen.ai/integrations/taggun/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Taggun integration for LuumenAI

Read receipt data through Taggun, and correct the merchant list behind it

## What LuumenAI can do with Taggun

LuumenAI connects to Taggun with an API token and exposes 14 tools (10 read-only · 4 write). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 14 tools (10 read-only · 4 write)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: AI & automation

## About Taggun with LuumenAI

Taggun turns receipt and invoice images into structured fields: merchant, total, tax, date, line items. Luumen reads those results directly, along with the known merchant and product code lists your account matches against. When a merchant keeps resolving to the wrong name, the fix is an approved write, not a ticket to whoever holds the API key.

## Example tools

Read-only (10 in total):

- `TAGGUN_EXPORT_KNOWN_MERCHANTS` — Export the complete list of known merchants used for merchant name normalization in Taggun.
- `TAGGUN_EXPORT_KNOWN_PRODUCT_CODES` — Export the complete list of known product codes used for product normalization and matching in Taggun.
- `TAGGUN_EXPORT_PRODUCT_CATEGORIES` — Export a list of product categories and descriptions used for product categorization in CSV format.
- `TAGGUN_GENERATE_MERCHANTS_CSV` — Generate a CSV file with mock merchant data for testing purposes.
- `TAGGUN_TRANSCRIBE_RECEIPT_ENCODED_SIMPLE` — Extract structured data from a receipt or invoice using base64 encoded image data.
- `TAGGUN_TRANSCRIBE_RECEIPT_ENCODED_VERBOSE` — Transcribe a receipt using base64 encoded image in JSON payload and return detailed results.
- `TAGGUN_TRANSCRIBE_RECEIPT_FILE_SIMPLE` — Upload a receipt or invoice image file and extract basic data including merchant name, total amount, tax amount, and date.
- `TAGGUN_URL` — Extract structured data from a receipt or invoice image using OCR.

Write and destructive (4 in total, subject to configured approval policy):

- `TAGGUN_ADD_MERCHANT_NAME` — Add a merchant name keyword to your account's model for predicting merchant names.
- `TAGGUN_IMPORT_KNOWN_MERCHANTS` — Import a list of merchant names and addresses to normalize and match in CSV or TSV format.
- `TAGGUN_IMPORT_KNOWN_PRODUCT_CODES` — Import a list of product codes in CSV or TSV format for normalization and matching.
- `TAGGUN_IMPORT_PRODUCT_CATEGORIES` — Import a list of product categories and descriptions for product categorization.

## Frequently asked questions

### How does LuumenAI connect to Taggun?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Taggun on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

Every call to Taggun — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/taggun/