---
title: "Receive a new Document"
method: POST
path: "/legal_entities/{legal_entity_id}/received_documents"
tags: ["ReceivedDocuments"]
---

# Receive a new Document

`POST /legal_entities/{legal_entity_id}/received_documents`

## Request

- Base URL: `https://api.storecove.com/api/v2`
- URL: `https://api.storecove.com/api/v2/legal_entities/{legal_entity_id}/received_documents`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/storecove/apis/storecove-api/docs/legal_entities/:legal_entity_id/received_documents/post.ts> (a function with typed inputs; its response is checked against the schema)

Let us know about a new Document you have received. It will be parsed and then you will receive the "received_document" webhook. You can use the information in the webhook to retrieve the parsed JSON or the original through a GET request.

## Path parameters

- `legal_entity_id` integer, required

## Request body

- ReceivedDocumentCreate
  - `document` string, required: The Base64 encoded document.
  - `parseStrategy` 'rfc822', required: The attachment content type (mime type).

## Response `200`

Success

- ReceivedDocument
  - `guid` string, uuid: The GUID of the received document

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity

## Changes

- **2025-05-16** `a036e500756b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/storecove/apis/storecove-api/changes/legal_entities/:legal_entity_id/received_documents/post.md)

---

[API](https://skmtc.dev/storecove/apis/storecove-api.md) - [All operations](https://skmtc.dev/storecove/apis/storecove-api/llms.txt) - [OpenAPI document](https://skmtc.dev/storecove/apis/storecove-api/revisions/18226354b6a5?raw)