WFM API 500 Internal Server Error when creating Evaluation Form

Genesys Cloud WFM
1

Looking for advice on creating Quality Evaluation forms via the WFM API during our Zendesk-to-GC migration.

Background

Migrating from Zendesk Satisfaction Surveys to Genesys Cloud Quality Management. Using Python SDK 1.15.0.

Issue

Calling POST /api/v2/wfm/quality/evaluations returns a 500 Internal Server Error. The request body matches the schema returned by a GET request on an existing form.

Troubleshooting

  • Verified timezone (Europe/Paris) matches Org settings.
  • Checked that the evaluation_type is set to agent.
  • No specific error details in the response body.
2

I’d suggest checking out at the JSON structure for the evaluation form. The 500 error often stems from missing required fields in the form object or invalid question references.

Ensure the id is null for new forms and that all question UUIDs match existing items. Check the server logs for specific validation failures.