topic Re: Complete a batch of callbacks limit in APIs & Integrations

Complete a batch of callbacks limit

KvanStaveren — Wed, 17 Dec 2025 12:09:34 GMT

Does anybody know what is the limit of this batch operation?

I have seen 100 and 500 in the docs of other endpoints, I would like to use prevent sending to much.

https://api.hubapi.com/integrators/timeline/v4/events

Re: Complete a batch of callbacks limit

MichaelMa — Wed, 17 Dec 2025 12:59:43 GMT

Hubspot batch operations usually uses the same system so I'm assuming the batch limits are the same for this object also (100 records at a time):

https://developers.hubspot.com/docs/api-reference/crm-contacts-v3/guide#limits

There are specific timeline limits that relate to other things (although documentation says this is for legacy apps so it might have been increased for their new apps):

You can create up to 750 timeline event types per public app. You can create up to 500 properties per timeline event type. Each serialized event instance has the following size limits: 500 bytes for the event instance ID 510 KB per property/token 1 MB in total size for the event instance

https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines#timeline-event-limits

There is also a rolling ten limit for APIs which is how many requests you can do in 10 seconds.

https://developers.hubspot.com/docs/developer-tooling/platform/usage-guidelines#rate-limits

Re: Complete a batch of callbacks limit

d-lupo — Wed, 17 Dec 2025 16:12:24 GMT

Hi @KvanStaveren,

I quote from the official HubSpot documentation:

Sending event occurrences

Send a single occurrence
Send a batch of occurrences

To send a batch of event occurrences, make a POST request to /integrators/timeline/v4/events/batch.In the request body, include up to 500 comma-separated event occurrence objects within an inputs array. If any occurrences in the batch fail to validate, no occurrences from the batch will be accepted.

Did my post resolve your question? If so, please consider marking it as the accepted solution to help others in the community.

Kind regards
Dennis

Re: Complete a batch of callbacks limit

GRajput — Thu, 18 Dec 2025 12:41:16 GMT

Hi @KvanStaveren
There is no limit for timeline events as of now; the limit is on bulk updates of other objects, which is 100 per batch.

I hope this will help you out. Please mark it as Solution Accepted and upvote to help another Community member.

Thanks!

Re: Complete a batch of callbacks limit

KvanStaveren — Fri, 19 Dec 2025 10:39:37 GMT

I tasted the wrong link whoops, I meant this batch operation

https://developers.hubspot.com/docs/api-reference/automation-actions-v4-v4/callbacks/post-automation-v4-actions-callbacks-complete

Re: Complete a batch of callbacks limit

BérangèreL — Fri, 19 Dec 2025 12:29:10 GMT

Hi @KvanStaveren and thank you for sharing the updated link!

While the documentation doesn’t currently specify the exact batch limit for the automation callbacks complete endpoint (POST /automation/v4/actions/callbacks/complete), it’s generally safe to start with batches of 100, as this matches the limit for most HubSpot batch endpoints, sometimes even up to 500 for timeline events.

I recommend testing with smaller batches to see what works best.

Also, it’s a great idea to submit feedback through the HubSpot Developer feedback form, this helps the team consider adding clearer documentation for the exact limits on this endpoint.

Thanks and have a wonderful weekend!
Bérangère