Estimated reading time: 5 minutes

If your company's processes depend on other tools besides Pipefy, you can count on our API to optimize your workflow. This is a low-code feature, so you need to know the basics about APIs to use it.

If this is your first experience with APIs, we recommend you start reading this article and take our basic API and integrations course offered for free.

We also have more content about this subject at Pipefy Developers and in our Community.

In this article, you will find:

What is an API?

API is an acronym for Application Programming Interface. It works as a connection between softwares or computers to simplify programming, making a more secure connection since an API only shows the information and actions essential to development.

What is it for?

In general, APIs avoid doing twice the work. You can use it to:

  • Transfer information from one software to another

  • Automate tasks in mass, such as creating cards and updating or deleting data

  • Edit fields in cards

  • Create and edit registers in your database

How to use Pipefy's API

Pipefy's API can integrate internal or third-party systems if they have a public API, and it must accept CORS (Cross-Origin Resource Sharing) requests. This mechanism allows a website to access resources from another one, even if it's a different domain. Learn more here.

Permissions

You must be a company administrator or pipe administrator to use an API. Members can view them, but they can’t execute any action.

GraphQL

GraphQL is a data query and manipulation language for APIs created by Facebook. This is also the name given to the back-end that provides information in GraphQL format. You can use it with other programming languages, like Node, Ruby, or Python.

👉 Here is an introduction to Pipefy's GraphQL endpoints.

👉 And here are references about queries, mutations, and more!

Access

The Integrated Development Environment (IDE) is another important point about GraphQL. Pipefy has two of them:

  • Public IDE: used to help with the commands. Mutations and any changes made in this area will reflect on your pipe. It's not possible to create automations or robots in it. In this IDE, it won't be necessary to setup an authorization code since this process is synced with the user authentication in Pipefy app.

  • Endpoint: where you will insert your API after testing it to automate your workflow.

Authentication

You need a token OAuth2 Bearer to authenticate Pipefy's GraphQL. Generate one following these steps:

  • Go to https://app.pipefy.com/tokens

  • Click on Generate new token

  • Give the token a description

  • Click on Save

  • Check on the token whenever it is needed to authenticate it on Pipefy

APIs calls limits

Each Pipefy's plan has a different limit of APIs calls per month:

  • Starter plan: until 20 API calls per month

  • Business plan: until 50 API calls per month

  • Enterprise plan: until 10.000 API calls per month

  • Unlimited: custom

Requests limits:

  • The number of subsequent queries allowed per unit of time is 500 requests every 30 seconds. If the limit is exceeded, the user will not be able to request the API for 5 minutes.

  • The number of webhooks configurations is based on the process's size and depends on the organization's subscription. We recommend not having more than 30 webhooks for each pipe, but this can vary.

  • Inputs and outputs are primarily based on the size of your process, using predefined queries and mutations. Overall, each request only returns 50 records, requiring the use of paging.

  • The size limit for the attached files is 512MB for each file.

  • For security reasons, the generated file links are only available for 15 minutes.

Related content:

Did this answer your question?