Loading

Salesforce REST API: 'You have reached the Connect API's hourly request limit' Error When Using Composite Batch

Date de publication: Jun 9, 2026
Description

When using the Salesforce Composite Batch REST API resource (endpoint: /services/data/vX.0/composite/batch), you may receive the error: "You have reached the Connect API's hourly request limit for this user and application." This error occurs when the number of Composite Batch requests exceeds 2,000 per user per hour.


The Composite Batch resource is built on top of the Connect API (also known as the Chatter REST API) batch framework, which enforces this hourly limit. The Composite Batch resource allows you to execute a sequence of independent sub-requests in a single HTTP call — for example, updating a record's name and then fetching the updated record in one request. However, this resource is not designed for high-volume or bulk data operations.


The Connect API (ConnectAPI) is the REST API framework that powers Chatter and social features in Salesforce. The Composite Batch resource leverages this framework internally, which is why Composite Batch calls count against ConnectAPI rate limits.



 

Résolution

The Composite Batch resource is not designed for doing a large number of SObject actions. If you are hitting this limit, use the appropriate API for your use case.

Recommended Alternative: Use APIs Designed for Bulk Operations

If your integration hits this limit, the Composite Batch resource is not the right tool for your use case. Use one of the following APIs depending on your operation type:

  • Bulk API 1.0 or 2.0: For large-scale data loads (insert, update, upsert, delete) of thousands or millions of records. Bulk API is asynchronous and optimized for high volume.
  • SOAP API: For synchronous, transactional operations where you need immediate confirmation of each record's result.
  • Tree Save API (composite/tree): For inserting multiple related records in a single call, up to 200 records per request.

Additional Resources (Updated)

  • Composite Batch Resource documentation (developer.salesforce.com)
  • Bulk API 2.0 Developer Guide
  • SOAP API Developer Guide
  • REST API Developer Guide


 
Learn more about composite batch here.

Numéro d’article de la base de connaissances

000382873

 
Chargement
Salesforce Help | Article