For Agents
Manage workflow pipes, cards, phases, and automations through a GraphQL endpoint for business process automation including approvals, onboarding, and service requests.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Pipefy API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Pipefy API.
Create and move cards through workflow phases for process automation
Query pipes and their phases to understand workflow structure
Manage card fields and attachments for work item data
Configure workflow automations and conditional triggers
GET STARTED
Use for: I need to create a card in a workflow pipe, I want to move a card to the next phase, Query all cards in a specific pipe phase, Retrieve the structure of a workflow pipe
Not supported: Does not handle project portfolio management, time tracking, or resource planning — use for structured workflow and process automation only.
Jentic publishes the only available OpenAPI specification for Pipefy API, keeping it validated and agent-ready. Pipefy API provides workflow and process automation through a GraphQL endpoint. The API enables managing pipes (workflow boards), cards (work items), phases (stages), fields, and automations, allowing teams to build, customize, and operate business processes including approvals, onboarding, procurement, and service requests.
Track process metrics and card movement through stages
Build custom business processes with configurable phases and fields
Patterns agents use Pipefy API for, with concrete tasks.
★ Business Process Automation
Automate approval workflows, procurement requests, and service delivery through Pipefy pipes. The GraphQL API creates cards in the appropriate pipe, moves them through phases as conditions are met, and triggers notifications at each stage. Teams replace email-based approvals with structured, trackable processes.
Create a new card in pipe ID 12345 with title 'Purchase Request' and fields for amount, vendor, and justification
Employee Onboarding Workflow
Manage new hire onboarding through a structured Pipefy pipe with phases for IT setup, HR paperwork, team introductions, and training. The API creates onboarding cards automatically when new employees are added, tracks completion of each phase, and notifies responsible parties at each stage.
Create an onboarding card for new employee 'John Smith' with start date and department fields, then query the phase structure of the onboarding pipe
Service Request Management
Process service requests through configurable pipes with intake forms, approval phases, and completion tracking. Pipefy handles the request lifecycle from submission through fulfillment, with fields capturing request details and phases enforcing the correct processing order.
Query all cards in the 'Pending Approval' phase of the service request pipe and list their titles and creation dates
AI Agent Process Orchestration
AI agents use the Pipefy API through Jentic to create cards, query workflow status, and advance processes without manual intervention. Agents search for workflow operations by intent, load the GraphQL schema, and execute mutations with Jentic handling Bearer token authentication.
Search Jentic for 'create workflow card', load the Pipefy GraphQL endpoint schema, and create a card with custom field values in the target pipe
1 endpoints — jentic publishes the only available openapi specification for pipefy api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/graphql
Execute GraphQL queries and mutations for all pipe operations
/graphql
Execute GraphQL queries and mutations for all pipe operations
Three things that make agents converge on Jentic-routed access.
Credential isolation
Pipefy Bearer tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens so raw personal access tokens never enter the agent context.
Intent-based discovery
Agents search by intent (e.g., 'create a workflow card') and Jentic returns matching Pipefy GraphQL operations with their schemas, so the agent can construct the right mutation without reading GraphQL docs.
Time to first call
Direct Pipefy integration: 2-3 days for GraphQL schema exploration, auth setup, and mutation building. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Pipefy API through Jentic.
Why is there no official OpenAPI spec for Pipefy API?
Pipefy uses a GraphQL API rather than REST, so there is no native OpenAPI specification. Jentic generates and maintains this OpenAPI wrapper so that AI agents and developers can discover Pipefy operations via structured tooling. Get started at https://app.jentic.com/sign-up.
What authentication does the Pipefy API use?
The Pipefy API uses Bearer token authentication. You generate a personal access token or OAuth token in the Pipefy app and pass it in the Authorization header. Through Jentic, this token is stored encrypted in the MAXsystem vault.
Can I create and move cards through workflow phases with the Pipefy API?
Yes. Use the createCard GraphQL mutation to add work items to a pipe, and moveCardToPhase to advance them through stages. You can also update card fields and add comments at each phase transition.
Is the Pipefy API REST or GraphQL?
The Pipefy API is GraphQL, accessed through a single POST /graphql endpoint. All operations (queries and mutations for pipes, cards, phases, fields) go through this endpoint with different GraphQL payloads.
How do I create a workflow card through the Pipefy API using Jentic?
Search Jentic for 'create workflow card', load the /graphql operation schema, and execute a createCard mutation with pipe ID and field values. Jentic handles Bearer token injection and GraphQL request formatting.
Can I query cards by phase or status in Pipefy?
Yes. Use the allCards query with phase_id filter to retrieve cards in a specific phase. You can also filter by assignee, due date, and custom field values to find cards matching specific criteria across your workflow.