API Use Case Examples

This section contains practical examples of how to use the Pipefy API for common use cases. These examples are organized into modules to help you find the specific functionality you're looking for.

Table of Contents

1. AI

• Agents usage details query
• Get an AI Agent by UUID
• Retrieve AI Agents
• Retrieve AI Agent Log Details
• Retrieve AI Agent Logs by Repo
• AI Agents Usage Details
• Template Agents Query
• Create AI Agent
• Update AI Agent
• Update AI Agent Status
• Delete AI Agent
• Update AI Settings Mutation
• Active LLM Providers Query
• Set Active LLM Provider Mutation
• Create LLM Provider
• LLM Providers by Organization
• Update LLM Provider
• Delete LLM Provider
• Provider Dependencies

2. Automation

• Automation
• Create automation
• Update automation
• Delete automation
• Automation actions
• Automation events
• Automations usage details query
• Retrieve automations
• Retrieve automation logs
• Retrieve automation logs by repo
• Get Automation Initial Values
• Get Automation Event Attributes
• List Automated Formula Operations
• Export Automation Jobs
• Simulate Automation Execution

3. Card and Field

• Add attachments to a card or field
• Create a card with required fields
• Create fields in a phase
• Move card to a different phase
• Create connected cards

4. Email and Communication

• Create and send an email through a card
• List emails from a card

5. Field

• Search for field dependencies

6. Form and Configuration

• Configure a start form on existing pipe
• Create a pipe with start form configured

7. Organization

• Organization usage stats
• Retrieve organization settings
• Track active users in your organization

8. Phase

• Create fields in a phase
• Move card to a different phase
• Update phase settings

9. Pipe

• Create a pipe with start form configured
• Get pipe flow (phases with related AI agents and automations)

10. Query Tips

• Get resource IDs
• Pagination basics
• Run multiple queries or mutations in a single request

11. Report

• Get reports
• Get organization report
• Get organization reports
• Create organization report
• Update organization report
• Delete organization report
• Export organization report
• Get pipe reports
• Create pipe report
• Update pipe report
• Delete pipe report
• Get pipe report columns
• Get pipe report filterable fields

12. Roles

• Create Custom Roles
• Delete Custom Roles

13. SMTP Configuration

• Create SMTP Configuration

14. SMTP Custom email

• Create SMTP Custom Email with Configuration

15. Tag

• Add tags to resource
• Create tags in bulk
• Retrieve Tag Categories of an Organization
• Tags by category
• Tags by category on resource
• Update tag category
• Create Tag
• Update tag
• Update tags visibility by category

16. Ticket

• See tickets

17. Usage Stats

• Agents usage details query
• Automation usage details query
• Organization usage stats

18. User

• Set user favorite pipes
• Set user roles via GraphQL mutation
• See users suggestions

20. Audit Logs

• Generate pipe audit logs report

About These Examples

These use cases demonstrate common integration scenarios and best practices when working with the Pipefy API. Each example includes:

• A detailed description of the use case
• Required API permissions
• Example GraphQL queries or mutations
• Sample responses
• Implementation notes and considerations

Whether you're building a new integration or looking to enhance existing functionality, these examples provide practical guidance for working with the Pipefy API.