This article outlines error messages that might be issued when calling methods of the Online Programs Participants API.
The Create Participant method might issue the following error messages:
| HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
FAILED_PRECONDITION (412) | PREMIUM_PLAN_REQUIRED | Premium plan required to add more participants beyond the free limit. | Upgrade to a premium plan to create additional participants beyond the free tier limit. |
FAILED_PRECONDITION (412) | PARTICIPANTS_LIMIT_EXCEEDED | Maximum participants limit exceeded for this program. | Check the program's participant limits and consider removing inactive participants or upgrading your plan. |
The Bulk Create Participants method might issue the following error messages:
| HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
INVALID_ARGUMENT (400) | MULTIPLE_PROGRAM_IDS_IN_BULK_CREATE | All participants in a bulk create operation must belong to the same program. | Ensure all participants in the request have the same programId. |
FAILED_PRECONDITION (412) | PREMIUM_PLAN_REQUIRED | Premium plan required to add more participants beyond the free limit. | Upgrade to a premium plan to create additional participants beyond the free tier limit. |
FAILED_PRECONDITION (412) | PARTICIPANTS_LIMIT_EXCEEDED | Maximum participants limit exceeded for this program. | Check the program's participant limits and consider removing inactive participants or upgrading your plan. |
The Issue Certificate method might issue the following error messages:
| HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
FAILED_PRECONDITION (412) | PARTICIPANT_NOT_ACTIVE | Participant isn't active or finished. | Ensure the participant is active or finished before issuing a certificate. |
FAILED_PRECONDITION (412) | NO_CERTIFICATE_REWARD | Program must have a certificate reward configured. | Configure a certificate reward for the program before attempting to issue certificates to participants. |
FAILED_PRECONDITION (412) | PARTICIPANT_NOT_COMPLETED_PROGRAM | The participant hasn't completed all required steps in the program. | Verify that the participant has completed all required program steps and has COMPLETED status. |
The Get Certificate Download URL method might issue the following error messages:
| HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
NOT_FOUND (404) | CERTIFICATE_NOT_ISSUED | The participant doesn't have an issued certificate. | Issue a certificate for the participant before requesting its download URL. |
NOT_FOUND (404) | CERTIFICATE_DOCUMENT_NOT_FOUND | No certificate document exists for the participant. | Issue the certificate again to create a new document. |
FAILED_PRECONDITION (412) | CERTIFICATE_NOT_READY | The certificate document hasn't finished rendering. | Retry the request after rendering completes. |
FAILED_PRECONDITION (412) | CERTIFICATE_RENDER_FAILED | The certificate document failed to render. | Issue the certificate again. If rendering continues to fail, contact Wix Support. |
FAILED_PRECONDITION (412) | CERTIFICATE_EXPIRED | The certificate document expired and is no longer available. | Issue the certificate again to create a new document. |
The Bulk Update Participant Tags and Bulk Update Participant Tags By Filter methods might issue the following error messages:
| HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
INVALID_ARGUMENT (400) | EMPTY_ASSIGN_AND_UNASSIGN_LISTS | No tags were specified to assign or unassign. | Include tags in either the assignTags or unassignTags field, or both. |
Last updated: 15 September 2026