Receiving usage_limit_exceeded

Example Error

{
  "data": {
    "createInboxEmail": null
  },
  "errors": [
    {
      "message": "You have reached the maximum number of emails that could be sent within a short period of time. Please try again soon.",
      "extensions": {
        "code": "USAGE_LIMIT_EXCEEDED",
        "correlation_id": "91cc075dcbe9d645-IAD"
      }
    }
  ]
}

Why This Happens

This error occurs when you exceed Pipefy’s rate limit for sending emails. By default, users are allowed to send 2 emails per minute. This limit prevents system abuse and ensures service stability.

Common Causes

1. Rapid-Fire Requests:
   1. Sending multiple emails in quick succession (e.g., via automated scripts or bulk operations).
2. Lack of Delay:
   1. No waiting period between email creation attempts.
3. Batch Processes:
   1. Running workflows or integrations that trigger emails in clusters.

How to Fix It

1. Wait and Retry
   1. Pause for 1 minute before retrying the request.
2. Add Throttling to Automated Scripts
   1. Introduce delays between email creation attempts.
3. Review Batch Operations:
   1. If using bulk actions, spread email sends over time to avoid hitting the limit..