---
title: "Action an Inbound Mail Item"
method: POST
path: "/inbound_mail_items/{inbound_mail_item_id}/action"
---

# Action an Inbound Mail Item

`POST /inbound_mail_items/{inbound_mail_item_id}/action`

Deposits or ignores each check contained in a pending Inbound Mail Item. Depositing a check creates a [Check Deposit](#check-deposits) into the Account you specify.

## Path parameters

- `inbound_mail_item_id` string, required — The identifier of the Inbound Mail Item to action.

## Request body

- ActionAnInboundMailItemParameters
  - `checks` object[], required — The actions to perform on the Inbound Mail Item.
    - `account_id` string — The identifier of the Account to deposit the check into.
    - `action` 'deposit' | 'ignore', required — The action to perform on the Inbound Mail Item.

## Response `200`

Inbound Mail Item

- InboundMailItem — Inbound Mail Items represent pieces of physical mail delivered to a Lockbox Address. Increase automatically deposits checks mailed to a Lockbox Recipient into the recipient's Account. Checks that are not matched to a Lockbox Recipient must be deposited or ignored using the Action an Inbound Mail Item endpoint.
  - `account_id` string, nullable, required — The identifier for the Account that checks in this mail item are deposited into. For mail items that could not be routed to a Lockbox Recipient, this will be null.
  - `checks` InboundMailItemCheck[], required — The checks in the mail item.
    - `amount` integer, required — The amount of the check.
    - `back_file_id` string, nullable, required — The identifier for the File containing the back of the check.
    - `check_deposit_id` string, nullable, required — The identifier of the Check Deposit if this check was deposited.
    - `front_file_id` string, nullable, required — The identifier for the File containing the front of the check.
    - `status` 'pending' | 'deposited' | 'ignored', nullable, required — The status of the Inbound Mail Item Check.
  - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Inbound Mail Item was created.
  - `file_id` string, required — The identifier for the File containing the scanned contents of the mail item.
  - `id` string, required — The Inbound Mail Item identifier.
  - `lockbox_address_id` string, required — The identifier for the Lockbox Address that received this mail item.
  - `lockbox_recipient_id` string, nullable, required — The identifier for the Lockbox Recipient that received this mail item. For mail items that could not be routed to a Lockbox Recipient, this will be null.
  - `recipient_name` string, nullable, required — The recipient name as written on the mail item.
  - `rejection_reason` 'no_matching_lockbox' | 'no_check' | 'lockbox_not_active' | 'lockbox_address_not_active' | 'lockbox_recipient_not_active', nullable, required — If the mail item has been rejected, why it was rejected.
  - `status` 'pending' | 'processed' | 'rejected', required — If the mail item has been processed.
  - `type` 'inbound_mail_item', required — A constant representing the object's type. For this resource it will always be `inbound_mail_item`.

## Other responses

- `4XX` — Error
- `5XX` — Error

## Changes

- **2026-08-29** `21462c0df069` — 1 info
  - added the required property `account_id` to the response with the `200` status

[Change history](https://skmtc.dev/increase/apis/increase-api-2/changes/inbound_mail_items/:inbound_mail_item_id/action/post.md)

---

[API](https://skmtc.dev/increase/apis/increase-api-2.md) · [All operations](https://skmtc.dev/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/increase/increase-api-2/revisions/21462c0df069/schema)