Creates a Document resource.
Through the document endpoint, PDF files can be sent to POM Collect. The PDF documents must be converted to a base64 string and placed in the document field. The API validates whether the provided base64 string represents a valid PDF file.
### Rate limit
Each document upload costs 40 points. See the *Rate limiting* section at the top of this documentation for how the shared limit works.
### Linking Documents and Collection Orders
It is possible to link a document to a CollectionOrder. The order of delivery is flexible and depends on whether a CID is provided in the document request. Both options require a debtor_number, but the validation process differs between them.
#### Option A: Create a Collection Order First, Then Link the Document
Linking occurs automatically if a CID is included in the payload. When creating a CollectionOrder first, a known debtor_number must be provided.
#### Option B: Deliver a Document First, Then Start a Collection Order
Using this option, a flow step is available that uses a file_mask. It checks the file_name for a specific attribute, such as an invoice number or payment reference. In this case, the provided debtor_number does not need to be known in POM Connect.
### Additional Notes
- The file_name must end with .pdf.
- The visible_for_debtor field allows you to specify whether the file should be visible in MijnDossier. This setting must also be enabled if the attachment is referenced in an email.
- The description field represents the subject of the document. It is also the display name in MijnDossier. Therefore, we recommend making the description unique. Example: *'Invoice 12345'*
curl -X POST "/v3/documents" \
-H "Authorization: Bearer $POM_API_DOCUMENTATION_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"debtor_number": 123456,
"file_name": "1234567890.pdf",
"description": "Factuur",
"cid": 1234567890,
"document": "Base64 encoded PDF file"
}'Authorization
AuthorizationstringheaderrequiredOAuth 2.0 client credentials Grant
Body
The new Document resource
debtor_numberstringrequiredfile_namestringrequiredvisible_for_debtorbooleanDefault:truedescriptionstring | nullcidinteger | nulldocumentstringrequired
Response
Document resource created
document_idintegerdebtor_numberstringdescriptionstringfile_namestringcidinteger | nullvisible_for_debtorbooleandate_createdstring<date-time>
{
"document_id": 0,
"debtor_number": "string",
"description": "string",
"file_name": "string",
"cid": 0,
"visible_for_debtor": true,
"date_created": "2026-01-15T09:30:00Z"
}