> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Errors

## Article: Errors

## Article Link: https://dev.wix.com/docs/api-reference/business-management/online-programs/participants/errors.md

## Article Content:

# Online Programs Participants API Errors

This article outlines error messages that might be issued when calling methods of the Online Programs Participants API.

## Create Participant errors

The [Create Participant](https://dev.wix.com/docs/api-reference/business-management/online-programs/participants/create-participant.md) 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. |

## Bulk Create Participants errors

The [Bulk Create Participants](https://dev.wix.com/docs/api-reference/business-management/online-programs/participants/bulk-create-participants.md) 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. |

## Issue Certificate errors

The [Issue Certificate](https://dev.wix.com/docs/api-reference/business-management/online-programs/participants/issue-certificate.md) 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. |

## Get Certificate Download URL errors

The [Get Certificate Download URL](https://dev.wix.com/docs/api-reference/business-management/online-programs/participants/get-certificate-download-url.md) 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. |

## Bulk Update Participant Tags errors

The [Bulk Update Participant Tags](https://dev.wix.com/docs/api-reference/business-management/online-programs/participants/bulk-update-participant-tags.md) and [Bulk Update Participant Tags By Filter](https://dev.wix.com/docs/api-reference/business-management/online-programs/participants/bulk-update-participant-tags-by-filter.md) 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. |