post
https://api.sumsub.com/resources/api/applicants/notes/attachments
Overview
Use this method to attach a file to an existing note in the applicant profile.
Info
A note must be created in the applicant profile before attaching a file.
File requirements
- Maximum file size: 10 Mb.
- Supported file formats:
jpg,png,pdf,doc,docx,xls,xlsx,odt,ods,txt.
Request example
curl -X POST \
'https://api.sumsub.com/resources/resources/api/applicants/notes/attachments' \
-H 'Content-Type: multipart/form-data' \
-F 'metadata={"id": "6893925cff736e92c020acaa", "applicantId": "687fb2373fc85ad66b5d6244"}' \
-F 'content=@/Sumsub/example_image.png'
Response explained
The response is a JSON file representing the note details. The following tables explain the response attributes.
| Field | Type | Description |
|---|---|---|
id | String | Note identifier. You may need it in case you want to edit a note, remove a note, or add an attachment. |
applicantId | String | Unique applicant identifier in the Sumsub system (applicantId).This identifier is a random combination of 24 digits and lowercase Latin characters. It is automatically generated when the applicant profile is created on the Sumsub side. |
note | String | Text of the note. |
createdAt | Date | Date and time when the note was added. |
createdBy | String | Identifier of the note author. |
updatedAt | Date | Date and time when the note was last updated. |
updatedBy | String | Identifier of the author who last updated the note. |
tags | Array of strings | Tags assigned to the note. |
attachments | Array of objects | Contains information about attached files. |
attachments element fields
attachments element fieldsThe following table explains the attachments element fields representing information about attached files.
| Field | Type | Description |
|---|---|---|
id | String | Identifier of the attached file. |
fileName | String | Name of the file. |
createdAt | Date | Date and time when the file was attached. |
createdBy | String | Identifier of the attachment author. |
fileSize | Integer | Image file size (in bytes). |
Response examples
If the request is sent and processed successfully, you will receive a response like the following:
{
"id": "6893925cff736e92c020acaaa",
"applicantId": "687fb2373fc85ad66b5d6244",
"note": "note example 3",
"createdAt": "2025-08-06 09:54:11+0000",
"createdBy": "example_user",
"tags": [
"First tag",
"Second tag"
],
"attachments": [
{
"id": "6893a5c660e0659e03327608",
"fileName": "example_image.png",
"createdAt": "2025-08-06 18:58:14+0000",
"createdBy": "example_user",
"fileSize": 733158
}
]
}
If the request fails, you will receive an HTTP response containing an error code along with a message explaining the error. For example:
{
"description": "Malformed data provided in the request",
"code": 400,
"correlationId": "f23e05c9f1a0aa2beb83065f98dc0544"
}