---
title: "Magnetic integration for LuumenAI"
url: "https://www.luumen.ai/integrations/magnetic/"
entity: SoftwareIntegration
category: "Project management"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Magnetic integration for LuumenAI

Read jobs, clients, and tasks in Magnetic, then create work with approval

## What LuumenAI can do with Magnetic

LuumenAI connects to Magnetic with an API token and exposes 14 tools (12 read-only · 2 write). 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: 14 tools (12 read-only · 2 write)
- Plan: available on all plans
- Category: Project management

## About Magnetic with LuumenAI

Connect Magnetic and your agent can look up opportunities and jobs, check grouping and opportunity statuses, search client contacts, and see who is on the team. When a new job or task needs to exist, the agent drafts it, shows you the fields, and waits for your approval before writing. Luumen authenticates with an API key.

## Example tools

Read-only (12 in total):

- `MAGNETIC_CLIENTS_GET_CURRENT_FOLLOWUPS` — Retrieve upcoming follow-ups assigned to the authenticated user.
- `MAGNETIC_CLIENTS_SEARCH_CONTACTS` — Search contacts by field or client ID.
- `MAGNETIC_GET_CONTACT_TAGS` — Get all tags associated with a contact.
- `MAGNETIC_GET_GROUPING_BY_ID` — Retrieve details for a specific grouping (opportunity/job) by its ID.
- `MAGNETIC_GET_GROUPING_STATUSES` — Retrieve the list of statuses for signed groupings.
- `MAGNETIC_GET_GROUPING_TAGS` — Retrieve tags associated with any groupings owned by the company.
- `MAGNETIC_GET_OPPORTUNITY_STATUSES` — Retrieve opportunity statuses.
- `MAGNETIC_GET_TASK` — Retrieve a task by its ID.

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

- `MAGNETIC_CREATE_GROUPING` — Create a new opportunity or job (grouping) in Magnetic HQ.
- `MAGNETIC_CREATE_TASK` — Create a new task in Magnetic HQ.

## Frequently asked questions

### How does LuumenAI connect to Magnetic?

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

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default. Administrators configure that per tool.

### Is there an audit trail?

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

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