Microsoft Graph connectors API limits
This article describes implementation and operational limits for Microsoft Graph connectors. Keep these limits in mind when designing connectors.
Connection limits
| Limit type | Limit |
|---|---|
| Connection resources per Microsoft 365 tenant | 30 |
| Items per connection | 5,000,000 |
| Connection byte size | 500 GB |
| Items per tenant | 50,000,000 |
Schema limits
| Limit type | Limit |
|---|---|
| Properties that can be defined in a schema, characterizing the data ingested through a connection | 128 |
Group limits
| Limit type | Limit |
|---|---|
| External groups per Microsoft 365 tenant | 100,000 |
| Requests allowed per second (requests/sec) in the group administration throttling threshold | 1,000 |
| External groups per user for search query | 10,000 |
Item ingestion
| Limit type | Limit |
|---|---|
| Throughput limit to ingest items through a connection | 25 items/sec |
| Item size; this limit applies to the request body when ingesting and indexing an item | 4 MB |
| Number of activities; this is the throttling threshold per activities call | 20 activities |
| Property size | N/A |
Note: The 4 MB item size limit refers to the total size of parsed text content that is typically 10% of the original file size for common formats (for example, docx, ppt, and PDF). To contextualize, 4 MB equals 4,000,000 bytes that translates to approximately 600K-700K words or 1,400 pages (averaging 500 words per page).
Throttling
When a throttling threshold is exceeded, Microsoft Graph limits any further requests from that client for a period of time. When throttling occurs, Microsoft Graph returns HTTP status code 429 (Too many requests), and the requests fail. A suggested wait time is returned in the response header of the failed request.
Throttling behavior can depend on the type and number of requests. For example, if you have a high volume of requests, all request types are throttled. Threshold limits vary based on the request type. Therefore, you could encounter a scenario where writes are throttled but reads are still permitted.