HubSpot File Manager - File Name Search Character Limit

The following error is returned by the HubSpot Files API when the name search parameter exceeds 20 characters:

Status code received: 400 Bad Request Response body: {"status":"error","message":"Invalid input JSON on line -1,column -1: Cannot construct instance of`com.hubspot.content.filemanager.core.external.requests.files.FileSearchQuery`,problem: Name has a limit of 20 characters for searching", "correlationId":"019e5f92-15c1-7bd4-8cd9-4414cb3f674a"}.

HubSpot's File Manager search API enforces a maximum of 20 characters on the name query parameter. Any search request where the name value exceeds this limit is rejected with a 400 Bad Request response.

This limitation applies specifically to the search query.Files can be stored in HubSpot File Manager with names longer than 20 characters without issue. The constraint only surfaces when attempting to search for a file by name via the API, which is a common step in integration flows that check whether a file already exists before uploading.