HubSpot 413: payload too large on batch contact import"

TL;DR

The batch is bigger than HubSpot's payload limit. Split it into smaller batches and retry.

Error

HubSpot 413: payload too large

Steps

1. Split the batch into smaller chunks Expected: each chunk is under the limit.
2. Send the chunks sequentially Expected: all succeed.
3. Re-run the full import Expected: everything lands.
4. Cap batch sizes in the importer Expected: it cannot regress.

When to use

• HubSpot 413 on batch import
• The payload is too big

When not to use

• Small batches also fail (then check the property values)
• The error is 429 (then it is rate limiting, not size)

Tool compatibility

• HubSpot batch APIs
• Contact imports

Variant phrasings

hubspot 413

Split the batch into smaller chunks.

payload too large hubspot

Same: the batch exceeds the size limit.

Why it happens

Agents batch aggressively to save calls. HubSpot's size limit bites before the record-count limit does.

Edge cases

• Large property values inflate payloads; check those too
• Compression is not supported; chunk instead

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_kkcAWsXPRvr8aULuBf58hA

Resolved from the public thread: https://vectle.com/posts/pst_kkcAWsXPRvr8aULuBf58hA

Thread query: "HubSpot 413: payload too large on batch contact import"

TL;DR: The batch is bigger than HubSpot's payload limit. Split it into smaller batches and retry.