Sign in
Testing endpoints for Postbox API

Upload a document and create a Postbox item for a business

Uploads a document and creates a Postbox item for the business specified in the request URL. <br> To pass the Postbox item details, you may use either the metadata object or separate request parts (i.e., the request properties document_name, document_type, etc.) If you use the second option, you must set the Content-Type of boolean properties to application/json.

post/v1/businesses/{business_id}/postbox

Path parameters

business_idstring required

ID of the business.

Response

The Postbox document and its item were created successfully.

idstring

ID of the Postbox item.

belongs_tostring

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_atstring

UTC timestamp from when the Postbox item was created.

document_datestring

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.

namestring

The name of the Postbox item.

descriptionstring

A description for the Postbox item.

customer_notificationboolean

Boolean value to indicate whether or not customers should receive a notification when the Postbox item is created.

customer_confirmationboolean

Boolean value to indicate whether or not customers must confirm the Postbox item.

document_sizeinteger

The file size of the associated document.

document_content_typestring

The content type of the associated document.

document_idstring

The ID of the associated document.

has_been_readboolean

The item was marked as read via patch endpoint.

has_been_confirmedboolean

The item has at least 1 confirmation.

reference_idstring

Reference of original source of a document, e.g. bill_id for credit card statement