API rate limiting

PipeOne offers an API that enables any system to integrate directly with our platform for:

  • Sending and receiving messages across any channel

  • Managing contacts - reading, editing, creating

  • Controlling contact tags.

If your company is interested in configuring this integration, please contact our support team at help@pipeone.me to request access.

What is API rate limiting?

API rate limiting is a method used to control how many requests a client can make to an API within a specific timeframe. This ensures fair usage, protects the system from abuse, and maintains the stability and reliability of the service for all users.

PipeOne API V1 rate limit rules

  • Request limit: Each client can make up to 200 requests per minute.

  • Error response: If you exceed this limit, the API returns an HTTP 429 (Too Many Requests) error.

Example error response: 

 { "status": "error", "message": "Rate limit exceeded. Try again in 1 minute." }
 

Penalties for violations

  • Single violation: After exceeding the limit once, you must wait 1 minute before making new requests.

  • Repeated violations: If the limit is exceeded three times in a short period, the penalty increases and your access will be blocked for 10 minutes.

Example extended block response:

{ "status": "error", "message": "Rate limit exceeded. Try again in 10 minutes.", "blocked_until": "2024-12-02 21:54:56" }

How does it work?

When a client exceeds the allowed number of requests, they are temporarily blocked and must wait until the penalty period ends before making new requests. This system ensures that all users have fair access to the API and that resources are not monopolized by a single client.

 

By following these limits, clients help maintain the stability and performance of the PipeOne API for everyone.

For integration requests or more information, please contact our support team at help@pipeone.me

Product Team