Using API v1? See what changes in v2, or the v1 docs

VALIDATION_PAYLOAD_TOO_LARGE

The request body exceeds the size limit for this endpoint.

HTTP status: 413. Retrying the same request returns the same error.

What to do

Keep files within the limit in the error message, send a Content-Length header with large files, or attach a link to the file instead.

Hint returned with the error: Send a smaller request body. The error message includes the limit.

Why it happens

  • An attachment larger than the account's limit: 25 MB through Pyas, shown in its status as capabilities.maxAttachmentBytes
  • A file larger than 25 MB sent without a Content-Length header

Endpoints that return it