Pipefy Developers

Welcome to the Pipefy Developer hub. You'll find comprehensive guides and documentation to help you start working with pipefy as quickly as possible, as well as support if you get stuck. Let's jump right in!

193 Topics

nsbrown
nsbrownRegular Participant
asked in API

Creating a card with an option field via api

Hey, So I can create a card which works fine via Javascript, the issue I’m facing is populating the radio field. Here’s my code:const query = `mutation { createCard(input: { pipe_id:302543188, title: "New card 2", fields_attributes:[ {field_id: "options", value: "Yes"}, ], }) { card { title } } }` The field in question has a name “Options” with a yes and no option. Any help would be great.

2
nsbrown
1 year ago
mauricio-rodrigues2
mauricio-rodrigues2Regular Participant
asked in API

Extract all activities from the card

Hello,Please, could someone tell me if the Pipefy API can extract all activities data from a card?Example:The user moved from Inbox to Making;The user moved from Done to PeersI need to have the life of the card, entrances and exits of the phases in an accumulative way.Example:Card created at 20:00The user moved from Inbox to Making at 21:00The user moved from Making to Inbox (again); 21:30And so on ...

3
Lucas Democh
1 year ago
zevi
zeviRegular Participant
asked in API

pipefy api

Hi I'm trying to use the pipefy API and every time I send the request the response I get is                Access to XMLHttpRequest at 'https://api.pipefy.com/' from origin 'https://www.mywebsite.com' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.I would appreciate if you could take your time to help me thanks 

3
genietim
1 year ago
rafael-pitanga
rafael-pitangaRegular Participant
asked in API

How do I get and insert data to a table via Postman?

Hi all, How can I find a simple example of how to search table data and to insert data into a custom table with columns like: “Title”, “First Name”, “Last Name” and “E-mail”. I am trying that using Postman, but the only response I got was Bad Request. Is there any link or tutorial explaining how to achieve that? Thanks! 

3
genietim
1 year ago
mauriciobl
mauricioblRegular Participant
asked in Customs Apps & Integrations

Export in CSV or XML

[EN]Hi, we’d like to know if there is a way to export data from cards, on a specific phase of a process, in formats other than XLS. More specifically in CSV or XML.Thank you in advance. [PTBR]Olá, gostaríamos de saber se existe uma maneiro de exportar dados de cards, em uma fase específica de um processo, em outros formatos além de XLS. Mais especificamente em CSV ou XML?Desde já, Obrigado

3
mauriciobl
1 year ago
michael-cope
michael-copeNew Participant
asked in API

Additional Card Information from Webhooks

Hello Pipefy team. I have been experimenting with webhooks to better automate our processes. I noticed that when I get a response, that the only information I receive is the card ID, and a pipe ID. Because of this, I have to execute an additional query to find the phase ID, and other information. Is it possible to have the webhook response include that kind of thing? It would be great if I could include all of the same information in the webhook response, that I could get in a query.

1
Marcos Carvalho
Pipefy Staff
1 year ago
Juliana Spinardi
Pipefy Staff
Juliana SpinardiPipefy Staff
published in API

New GraphQL API update: Batch field updates for Cards and Database Records

We released a new API mutation called updateFieldsValues that will allow users to update up to 30 fields in a single API call. This new mutation will improve the overall developer experience when handling batch updates and will significantly improve the speed of batch updates, by reducing the number of API calls. 📌 Incremental updatesThis new API mutation also allows developers to update fields that contain multiple data by just adding a new value or removing an existing value.For example, to add a label to a label field, previously developers would need to do two API calls, an API call to get all existing labels, use this list to append the new label and then send to Pipefy in another API call the new list of all the labels. With the new mutation updateFieldsValues, developers can send an API mutation telling Pipefy to only add a new label to the existing list of labels in a​ field, the same applies to assignees, connections and checklists fields. Sample GraphQL mutationUpdating two

11706
camila-borges1
1 year ago
gabrielritchie
gabrielritchieRegular Participant
asked in Customs Apps & Integrations

adding google maps to portals

We currently have an enquiry portal but want to integrate google maps with zipcode so customers can show us their house roof. Is there a way to integrate google maps into a portal so the dats feeds into a pipe card?

1
Juliana Spinardi
Pipefy Staff
2 years ago
ggmeyd
ggmeydRegular Participant
asked in API

Query

Hello, I need to use APi to pull the phase of the card, or rather its name, gives the following error:No query string was presentWhat exactly do I need to enter for the call to be correct?Using this Body:query {  card(id: 513360781) {    title   current_phase {     name   }    id    updated_at  }}

4
Lucas Democh
2 years ago
Juliana Spinardi
Pipefy Staff
Juliana SpinardiPipefy Staff
published in Customs Apps & Integrations

Style

☝️ Style -  We provide to you a CSS with style guide from Pipefy.Include the following CSS to your IFrames  Click here for details and usage 

2147
Sarah Lane
2 years ago
lucass-web
lucass-webNew Participant
asked in API

Issue in graphql pagination parameters

Hello everyoneI have a query to filter set of cards using CardSearch as example: above, has the query and the search result, the pagination parameters returned inform that I have more pages to be seen when I update the query to bring up the next page, I get the following return the curious thing is that there are card titles where pagination works normally, for example:for cards with title = "Almir Mario Bitto" the pagination does not work.for cards with title = "Filipe Gomes de Lima" pagination works normally    Are there any details to be adjusted in the query?I appreciate any help

2
Alex Dowbor
2 years ago
daniel-levy2
daniel-levy2New Participant
asked in API

Trouble with error handling on Card Move through API

Hello everyone,I am developing a simple application that will be integrated with Pipefy, and I will need to allow cards to be moved between phases with calls to the GraphQL API. The issue I am having is that there are certain fields that need to be updated before a card can move to a particular phase. When those fields are not set and the API call is made, the error that returns is very general: “Card could not be moved to phase id: <ID>”Is there anyway to make this error message more specific so that I could display to the user why it is failing? I thought I was able to do it when experimenting through Postman but now I cannot seem to find the call I madeAny help on this would be greatly appreciatedThanks!

1
genietim
2 years ago
juliamsantarosa
juliamsantarosaRegular Participant
asked in Customs Apps & Integrations

Date enters the phase

Hello community!How do I find out the date the card entered the phase?Thanks for the attention.

3
alicereis
2 years ago
ramongb
ramongbRegular Participant
asked in API

What is "clientMutationId" used for?

I see that “clientMutationId” is always needed as part of the GraphQL payload. But What is this for??In the result from GraphQL always come back as NULL. In the Dev Docs says “A unique identifier for the client performing the mutation.” Can I register a Client for the miutation? Thanks!

3
Roberto Chavarria
Pipefy Staff
2 years ago
tsartori
tsartoriSuperuser
asked in API

Pipefy -> PowerBI Integration

English Hello, I am trying to connect Pipefy and PBI, with the power Query and a GraphQL API, but i cant find the right URL to put in. It keep me returning the error 400 or 404.May someone help me? Português Olá,Estou tentando conectar o Pipefy e o PowerBI através do Power Query e uma API de GraphQL, porém as URLs sempre dão erro 404 ou 400.Alguém sabe me ajudar?

13
murilova
2 years ago
Marcos Carvalho
Pipefy Staff
Marcos CarvalhoPipefy Staff
published in API

💎 Pipefy GraphQL API Reference documentation is now updated!

Hey everyone! Pipefy GraphQL API Reference documentation https://api-docs.pipefy.com is now updated!In this new version we fixed some broken links and also all latest mutations, queries or any other changes in our GraphQL API are now available. This is way of improving even more Pipefy integrations capabilities and deliver better documentation to our customers and developers community.But it's important to remember that our official documentation page is https://developers.pipefy.comThis is the home page where developers can have access to other documentation features like code examples, articles about GraphQL and many more.When it’s necessary a more in depth documentation, then the GraphQL API Reference is the place for it! It's a reference containing all possibilities to work with the Pipefy API explaining the concepts of Card, Pipe, Table, etc. and also available fields, required fields and their data types.We hope you like it and feel free to give us feedbacks and ideas. 

6332
Marcos Carvalho
Pipefy Staff
2 years ago
Tegrus
TegrusRegular Participant
asked in API

Get child pipes in pipe query

I can’t get information about the child/parent pipes in Pipe query. I make a query like this one below:{ pipe(id: "form id here") { childrenRelations { child { __typename } } }}And the only property I can get from the child/parent is __typename and the result is this:{ "data": { "pipe": { "childrenRelations": [ { "child": { "__typename": "Pipe" } } ] } }}I want to know at least the child pipe ID. I tried the pipe_relations query, but it has the same limitations. The only way I could get some information about the pipes in the relations was in card query, but I need that information before a card is created.

1
genietim
2 years ago
Marcos Carvalho
Pipefy Staff
Marcos CarvalhoPipefy Staff
published in API

💡 Pipefy User Management API

Hi everyone! It’s Marcos from Pipefy Engineering team.  Pipefy has released a new set of functionalities in our GraphQL API to enable user management in Organizations (a company’s account in Pipefy), Pipes (processes) and Tables (databases). New mutations, queries and webhooks were created in order to manage users and their roles through API, enabling many possibilities of integrations between Pipefy and Active Directory or any other user provisioning application and helping administrators to have more control, governance and security over organization users. Here some more details about these new possibilities in our API documentation Changelogs:  User Management Mutations ​​​​​​User Management Webhooks For more information, please refer to Pipefy Developers page. Hope you like it and if you have any questions or suggestions, please let us know!  

3350
Marcos Carvalho
Pipefy Staff
2 years ago
davi96
davi96Regular Participant
asked in API

Is there a wait to get a pipe report via API or save a pipe's information to a table that could be pulled via API?

I don’t think it’s possible to directly get a pipe report via API, since I haven’t find anything related in the docs. Anyway, I’d be happy if I’m wrong on that.However, I can directly pull tables  - from the “database” feature - via API. So a workaround on pulling reports would be to connect the pipe to a table and then pull this table using the API. To be more precise on what I mean to connect pipe and table: create some kind of automation that would, for example, save to a table every cards’ id, title and current phase. Is there a way to do something similar?

4
davi96
2 years ago
Lucas Democh
Lucas DemochPipefy Legend
published in API

Solutions for Tag Update via API

I identified 3 ways to update tags through GraphiQL. You should use the most appropriate format for your process. Scenario A) Updating a single tag. Solution 1: This is the simplest scenario and should only be used if your Pipe has only one label field. mutation{ updateCardField(input: {          card_id: XXXXXXXX field_id:"label_1"          new_value:"XXXXXXXX" }) { clientMutationId success } }In this format, as the update is from a field to a label, there is no problem. Scenario B) Updating multiple labels in different fields. For this scenario, there are several solutions, as simply updating the label fields does not guarantee that the card labels are properly updated / synchronized with the Card labels. Solution 2: Update more than one tag field, each field with a tag.mutation{ m1: updateCardField(input:{ card_id:XXXXXXXX field_id:"label_1",new_value:"XXXXXXXX" } ) { card { id } }m2: updateCardField(inp

3493
Lucas Democh
2 years ago
jason147
jason147Regular Participant
asked in API

Update database with connected cards

Hi, I was wondering what API to use for updating databases based on their connected cards e.g. Data gets updated so I need to auto update the database OR a card gets moved to archive so I want to remove the Data I am someone with very little coding knowledge (But I am learning, currently with html but moving onto python)

1
Lucas Democh
2 years ago
davi96
davi96Regular Participant
posted in Customs Apps & Integrations

How to test if webhook is working?

I created a webhook in a pipe in order for it to export data to a Google Cloud Function that will, in turn, send it to a Google Cloud Pub/Sub topic.The Cloud function is all set up and tested, surely working when I do a POST request using curl with the same token.I set up the webhook using https://app.pipefy.com/graphiql with the following piece of code:mutation{ createWebhook(input:{ actions:"card.move" name:"Webhook-Test" url:"https://MY_CLOUD_FUNCTION_URL" email:"MY_EMAIL@MY_COMPANY.com" pipe_id:302214108 headers: "[{\"Authorization\":\"Bearer MY_VERY_LONG_TOKEN\"}]" }) { clientMutationId }}And it actually does create a webhook, as I could verify with the following piece of code:{pipe(id:302214108){id webhooks{id url headers actions}}}However, when I move some cards to test it, I don’t see any invocation in the cloud function dashboard. Is there a way to test and monitor the webhook? Any ideas that could help solve this? I’m totally lost with this, since I

3
Lucas Democh
2 years ago
sommardahl
sommardahlNew Participant
asked in API

You don't have permission to connect these cards/table records.

Hello,I am attempting to create a db record on the GraphQL API. The table (called “Assessments”) has a database connection field called “Candidate”. From the API, as I attempt to set the field values, I add a valid identifier for “Candidate” (candidate exists and the “Candidates” table, the value I’m setting is the title field). IF the same candidate has not been added to another assessment, the mutation is successful. IF the same candidate is already present on another assessment, the mutation fails with the following error: “Error on field "Candidate": Value You don't have permission to connect these cards/table records.” I’d like to stress that THIS QUERY WORKS as long as the Assessments table does not already contain an assessment with the same candidate that I’m attempting to add. So, I don’t personally believe the problem is in the query. I believe the problem might come from my own understanding of how Pipefy works. On the other hand, I definitely expect Pipefy to ALLOW what I’m

1
rafaela-marques2
Pipefy Staff
2 years ago
davi96
davi96Regular Participant
asked in API

Info {"errors":[{"message":"Unexpected end of document","locations":[]}]}

I’m trying to get data from a pipe using Google Apps Script and keep getting the error:Info {"errors":[{"message":"Unexpected end of document","locations":[]}]}I don’t think the problem is with the general script’s structure, since it works when I run another query.Also, I’m new to GRAPHQL - this is the first time I use it, for instance - so that’s another reason why I believe the problem might be in the query.A piece of the script I used to try is: const query = `{ allCards(pipe_id:${pipe_id}){ edges{ node { title current_phase { name } createdBy { name } createdAt fields { value name } } } }`; const graphql = JSON.stringify({ query: query, variables: null, }); const params = { method: "GET", payload: graphql, headers: { "Content-Type": "application/json", Authorization: `Bearer ${TOKEN}`, }, }; var response = UrlFetchApp.fetch(url, params);pi

1
davi96
2 years ago
rodolfo-silva5
rodolfo-silva5New Member
asked in API

problem using example in NodeJs

Hi, I'm using node, and I got the example in the documentation, but when I run it, it gives me this error, and on the site where the example is executed, it's running normally.Thanks.Link example: https://developers.pipefy.com/reference/graphql-endpoint Code:sdk['graphql-endpoint']({ query: '{allCards(pipeId: 302194528){edges{node{id}}}}'}, { Authorization: 'Bearer *token*'}) .then(res => console.log(res)) .catch(err => console.error(err)) Response:​{>    '0': {>      instancePath: '/paths',>      schemaPath: '#/additionalProperties',>      keyword: 'additionalProperties',>      params: { additionalProperty: '' },>      message: 'must NOT have additional properties',>      isIdentifierLocation: true>    },>    stack: 'SyntaxError: OpenAPI schema validation failed.\n' +>      '\n' +>      'ADDITIONAL PROPERTY must NOT have additional properties\n' +>      '\n' +>      '  24 |   ],\n' +>      '  25 |   "paths": {\n' +>      '> 26

0
rodolfo-silva5
2 years ago

Community Experts Leaderboard

Terms & ConditionsCookie settings