---
title: "Postgrid integration for LuumenAI"
url: "https://www.luumen.ai/integrations/postgrid/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Postgrid integration for LuumenAI

Check on mailed letters, cheques, and postcards — and send or cancel with approval

## What LuumenAI can do with Postgrid

LuumenAI connects to Postgrid with an API token and exposes 60 tools (29 read-only · 19 write · 12 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: 60 tools (29 read-only · 19 write · 12 destructive)
- Plan: available on all plans
- Category: Source control & CI/CD

## About Postgrid with LuumenAI

Connect PostGrid and Luumen can look up any letter, cheque, postcard, box, or tracker by ID, read the contacts and templates behind them, and list bank accounts. Sending new mail, ordering return envelopes, or canceling a cheque runs as a previewed step you approve first. Luumen authenticates with an API key.

## Example tools

Read-only (29 in total):

- `POSTGRID_GET_BANK_ACCOUNT` — Retrieve a bank account.
- `POSTGRID_GET_BOX` — Retrieve a specific box order by ID.
- `POSTGRID_GET_CHEQUE` — Retrieve a specific cheque by ID.
- `POSTGRID_GET_CONTACT` — Retrieve a contact.
- `POSTGRID_GET_LETTER` — Retrieve a letter.
- `POSTGRID_GET_POSTCARD` — Retrieve a specific postcard by ID.
- `POSTGRID_GET_RETURN_ENVELOPE` — Retrieve a return envelope.
- `POSTGRID_GET_RETURN_ENVELOPE_ORDER` — Retrieve a specific return envelope order.

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

- `POSTGRID_CANCEL_BOX` — Cancel a box order by its ID.
- `POSTGRID_CANCEL_CHEQUE` — Cancel a cheque order by its ID.
- `POSTGRID_CANCEL_CHEQUE_WITH_NOTE` — Cancel a cheque order with a cancellation note.
- `POSTGRID_CANCEL_POSTCARD` — Cancel a postcard order.
- `POSTGRID_CANCEL_POSTCARD_WITH_NOTE` — Cancel a postcard order with an optional cancellation note.
- `POSTGRID_CANCEL_RETURN_ENVELOPE_ORDER` — Cancel a return envelope order.
- `POSTGRID_CREATE_BANK_ACCOUNT` — Create a new bank account for print & mail service.
- `POSTGRID_CREATE_BOX` — Create a box mailing order for letters with plastic cards or cheques.

## Frequently asked questions

### How does LuumenAI connect to Postgrid?

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

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

### Is there an audit trail?

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

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