GraphQL vs REST in Perfex CRM: When to Use Each

The Same Module, Different Strengths

Data Builder gives Perfex CRM both REST API and GraphQL through a single module. They share authentication, security, and error handling. This guide helps you choose the right approach for each integration scenario.

Choose REST When

• You need simple CRUD on one table at a time

• Your integration platform expects HTTP endpoints (Zapier, Make.com, n8n)

• You want URL-based filtering and pagination

• You need polling with ?since= for incremental sync

• You are testing with Postman or curl

# REST: straightforward and predictable
GET https://databuilder.polyxgo.com/api/v1/invoices?status=2&sort=-total&per_page=5

Choose GraphQL When

• You need data from multiple tables in one request

• Your mobile app needs minimal data transfer

• Your dashboard combines clients + invoices + projects

• You want write operations with auto-generated input types

• Your frontend needs flexible field selection

# GraphQL: precise and flexible
{
  clients(limit: 5) {
    company phonenumber
    invoices(sort: "-total") { total status }
    projects { name deadline_date }
  }
}

Decision Matrix

Learn More

• How REST API Works (with examples)

• Complete GraphQL Guide (queries, mutations, introspection)

• Try both in the API Explorer