---
title: "Create a Postbox item for a business"
method: POST
path: "/v1/businesses/{business_id}/postbox/items"
tags: ["Testing endpoints for Postbox API"]
deprecated: true
---

# Create a Postbox item for a business

`POST /v1/businesses/{business_id}/postbox/items`

> **Deprecated.**

Deprecated! Use `POST /v1/businesses/{business_id}/postbox` instead.<br> Creates a Postbox item for the business specified in the request URL. Note that you can only use this endpoint for testing purposes on the testing, staging, and sandbox environments.

## Path parameters

- `business_id` string, required

## Request body

- ItemRequest
  - `name` string — The name to apply to the Postbox item.
  - `description` string — A description for the Postbox item.
  - `customer_notification` boolean — Boolean value to indicate whether or not customers should receive a notification when the Postbox item is created.
  - `customer_confirmation` boolean — Boolean value to indicate whether or not customers must confirm the Postbox item.
  - `document_id` string — ID of a document to associate with the Postbox item. Use the `POST /v1/postbox_documents` endpoint to upload test documents.
  - `idempotency_key` string — Optional property you may supply to prevent the execution of duplicate requests. If the API receives a request with a previously used idempotency key, then it will return the previously created entity.

## Response `200`

The Postbox item was created successfully.

- ItemResponse
  - `id` string — ID of the Postbox item.
  - `belongs_to` string — ID of the person or business with whom the Postbox item is associated.
  - `owner_type` 'Person' | 'Business' — Indicates whether the Postbox item is owned by a person or business.
  - `created_at` string — UTC timestamp from when the Postbox item was created.
  - `document_date` string — The date of the document associated with the Postbox item.
  - `document_type` 'ACCOUNT_STATEMENT' | 'BALANCE_CONFIRMATION' | 'CUSTOMER_INFORMATION' | 'DUNNING_INFORMATION' | 'LOAN_SCHEDULE' | 'SECURITIES_INVOICE' | 'SECURITIES_EVENT' | 'SECURITIES_EVENT_NOTIFICATION' | 'DEPOT_STATEMENT_MIFID' | 'EX_POST_COST_INFORMATION' | 'DEPOT_STATEMENT' | 'ASSETS_ACQUISITION' | 'ASSETS_ACQUISITION_COSTS' | 'PROFIT_TAX_STATEMENT' | 'YEARLY_TAX_STATEMENT' | 'TAX_SETTLEMENT_CALCULATION' | 'CREDIT_CARD_STATEMENT' | 'RELATIONSHIP_TERMINATION' | 'CREDIT_CARD_SECCI' | 'CREDIT_CARD_CONTRACT' | 'CREDIT_CARD_CONTRACT_SIGNED' | 'FEE_SUMMARY_STATEMENT' | 'SINGLE_FEE_STATEMENT' | 'SINGLE_TRANSACTION_STATEMENT' — The type of document associated with the Postbox item.
  - `name` string — The name of the Postbox item.
  - `description` string — A description for the Postbox item.
  - `customer_notification` boolean — Boolean value to indicate whether or not customers should receive a notification when the Postbox item is created.
  - `customer_confirmation` boolean — Boolean value to indicate whether or not customers must confirm the Postbox item.
  - `document_size` integer — The file size of the associated document.
  - `document_content_type` string — The content type of the associated document.
  - `document_id` string — The ID of the associated document.
  - `has_been_read` boolean — The item was marked as read via patch endpoint.
  - `has_been_confirmed` boolean — The item has at least 1 confirmation.
  - `reference_id` string — Reference of original source of a document, e.g. bill_id for credit card statement

## Other responses

- `400` — Invalid request.
- `403` — You are not authorized to perform this action.
- `404` — The provided business could not be found.
- `500` — Internal server error.

---

[API](https://skmtc.net/solarisgroup/apis/compliance-features.md) · [All operations](https://skmtc.net/solarisgroup/apis/compliance-features/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/compliance-features/revisions/61701b027c74/schema)