How to create FieldConditionals via GraphiQL Api

Você quer criar condicionais em um JSON?

I have been trying to manipulate field conditions through the API as well with no success…. Documentation states that createFieldCondition and updateFieldCondition are deprecated and will be removed. Might be the reason they won't work… It's a shame as it would save me hundreds of hours of work...

I’ve worked with Field Conditionals through the API before, and yes, it is possible to create them via GraphiQL  but the structure is very picky. The error “Actions field cannot be blank” usually appears when one of the keys inside the actions block isn’t in the exact format the API expects.

A few things you can double-check:

1. Field names must match the schema exactly
Sometimes the API uses fieldId instead of phaseFieldId, or type instead of actionId. A small mismatch can cause this exact validation error.

2. Structure of the actions block
What typically works is something like:

• type → show / hide

• fieldId → ID of the field you want to show/hide

If you send actionId, the API might ignore it and return that “blank actions” error.

3. Check your IDs
Make sure phaseFieldId is really the ID of the field, not the phase. Pipefy errors are vague and often return this same message when the ID doesn’t match.

4. Try sending a minimal mutation first
Remove the condition block and try creating the fieldConditional with only a name + a simple action.
If that works, then the issue is inside the condition structure.

5. “whenEvaluator” can be tricky
Some mutations don’t accept a raw boolean. I’ve had to either remove this field or pass it as a string ("true") depending on the scenario.

From my experience, the issue almost always comes down to the actions array not matching exactly what the Pipefy API expects. Once the correct field names and IDs are used, the mutation runs normally.