---
title: "Helpwise integration for LuumenAI"
url: "https://www.luumen.ai/integrations/helpwise/"
entity: SoftwareIntegration
category: "ITSM & ticketing"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Helpwise integration for LuumenAI

Read Helpwise conversations for context, then leave notes as approved steps

## What LuumenAI can do with Helpwise

LuumenAI connects to Helpwise with an API token and exposes 37 tools (18 read-only · 9 write · 10 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 37 tools (18 read-only · 9 write · 10 destructive)
- Plan: available on all plans
- Category: ITSM & ticketing

## About Helpwise with LuumenAI

Connect Helpwise and your shared inboxes become part of the agent's working context. It can read conversations, notes, contacts, tags, and mailbox settings to answer questions about what a customer reported and when. Changes — adding a note, updating a contact, editing a tag — are previewed and sent for approval before they land. Luumen authenticates with an API key.

## Example tools

Read-only (18 in total):

- `HELPWISE_GET_ATTACHMENT` — Retrieves a specific attachment by its unique identifier.
- `HELPWISE_GET_ATTACHMENTS` — Retrieves attachments from messages in a specific conversation.
- `HELPWISE_GET_CONTACT` — Retrieves detailed information for a specific contact by ID.
- `HELPWISE_GET_CONVERSATION` — Retrieves complete details of a specific conversation by ID from Helpwise.
- `HELPWISE_GET_CONVERSATIONS` — Retrieve a list of conversations.
- `HELPWISE_GET_CUSTOM_FIELD` — Retrieves details of a specific custom field by its ID.
- `HELPWISE_GET_MAILBOX` — Retrieve details of a specific mailbox by its ID.
- `HELPWISE_GET_MAILBOXES` — Retrieve mailboxes.

Write and destructive (19 in total, approval required by default):

- `HELPWISE_CREATE_ATTACHMENT` — Upload a new attachment.
- `HELPWISE_CREATE_NOTE` — Add a note to a conversation.
- `HELPWISE_CREATE_TEAM` — Creates a new team in Helpwise to group users for collaboration and assignment purposes.
- `HELPWISE_CREATE_WEBHOOK` — Creates a new webhook subscription in Helpwise to receive real-time event notifications.
- `HELPWISE_DELETE_CONTACT` — Deletes a contact from Helpwise by its unique identifier (ID).
- `HELPWISE_DELETE_CONVERSATION` — Attempts to delete a conversation by ID from Helpwise.
- `HELPWISE_DELETE_MAILBOX` — Delete a mailbox by its unique identifier.
- `HELPWISE_DELETE_MESSAGE` — Attempts to delete a message from Helpwise.

## Frequently asked questions

### How does LuumenAI connect to Helpwise?

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 Helpwise on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 10 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

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

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