​
Pipedream rate limits

The following rate limits apply to all Connect API endpoints:
NameEndpointRequest LimitScope
Create Connect TokenPOST /token100 per minutePer external user
Account ManagementGET | DELETE /accounts/*2,000 per 5 minutesPer project
List ToolsGET /components/*3,000 per 5 minutesPer project
Tool ExecutionPOST /components/*2,000 per 5 minutesPer project
API ProxyGET | POST /proxy1,000 per 5 minutesPer project
Tool Executions include POST requests to run actions, configure components, and reload props. All POST operations to /components/* endpoints share the 2,000 per 5 minutes rate limit.
Need higher limits? Contact our support team to discuss your requirements.

​
Custom rate limits

You can set custom rate limits for your users to control their usage of the Connect API and prevent runaway requests or abuse.

​
Create rate limit

Create a rate limit by specifying a time window and maximum requests allowed within that window. The API returns a rate_limit_token that you include in subsequent Connect API requests. 
POST /rate_limits

​
Parameters

ParameterTypeDescription
window_size_secondsintegerTime window duration in seconds
requests_per_windowintegerMaximum requests allowed per window

​
Example request

# First, obtain an OAuth access token
curl -X POST https://api.pipedream.com/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "{oauth_client_id}",
    "client_secret": "{oauth_client_secret}"
  }'

# Create the rate limit
curl -X POST https://api.pipedream.com/v1/connect/rate_limits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "window_size_seconds": 10,
    "requests_per_window": 1000
  }'

​
Response

{
  "token": "CiKpqRdTmNwLfhzSvYxBjAkMnVbXuQrWeZyHgPtJsDcEvFpLnE"
}

​
Using rate limit tokens

Include the rate_limit_token in the x-pd-rate-limit header for all Connect API requests: 
curl -X POST "https://api.pipedream.com/v1/connect/{project_id}/actions/run" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -H "x-pd-rate-limit: {rate_limit_token}" \
  -d '{
    "external_user_id": "user123",
    "id": "gitlab-list-commits",
    "configured_props": {
      "gitlab": {
        "authProvisionId": "apn_kVh9AoD"
      },
      "projectId": 45672541,
      "refName": "main"
    }
  }'