Troubleshoot Indeed Apply errors

Common Indeed Apply errors and how to resolve them.

 

How to detect errors

Indeed Apply uses GraphQL. When a request fails, the data field is null and the errors field contains information about the failure.

Always check the errors array in the response body:

{
  "data": null,
  "errors": [{
    "message": "Error description",
    "extensions": {
      "code": "BAD_USER_INPUT",
      "subCode": "JOB_NOT_FOUND"
    }
  }]
}

The extensions.code field contains the error type. For BAD_USER_INPUT errors, the extensions.subCode field provides the specific cause.

GRAPHQL_PARSE_FAILED error

GRAPHQL_PARSE_FAILED error

code	GRAPHQL_PARSE_FAILED
Summary	A GraphQL operation string contains a syntax error.

To resolve:

1. Verify the GraphQL query syntax.
2. Check for unescaped special characters.
3. See Troubleshoot GraphQL errors for detailed resolution steps.

BAD_USER_INPUT error

BAD_USER_INPUT error

code	BAD_USER_INPUT
Summary	The request contains invalid input. The message and subCode in extensions describe the specific cause.

The subCode field identifies the specific error:

BAD_USER_INPUT sub-codes

Sub-code	Description and resolution
JOB_NOT_FOUND	The job is not found with the provided sourceJobPostingId. Verify the ID is correct.
JOB_NOT_INDEEDAPPLYABLE	The job is not Indeed Apply enabled. Verify the job is configured for Indeed Apply.
JOB_EXPIRED	The job expired. Repost the job or create a new posting.
PARTNER_INTEGRATION_DISABLED	The partner is disabled or cannot use this integration method. Contact Indeed to enable Apply with Indeed for your partnerApiToken.
INVALID_PARAMETER	Input URLs or decrypted string is null or empty. Verify the parameter values.
PARTNER_DATA_NOT_FOUND	Partner data was not found for the requesting partner. Contact Indeed to register your partner API token.
FEED_NOT_FOUND	A feed ID does not exist with the provided inputs for XML Feed. Verify the feed configuration.
MULTIPLE_MATCHING_FEEDS_FOUND	A unique feed ID cannot be identified with the provided inputs for XML Feed. Provide more specific feed identifiers.

Example error response

{
  "errors": [{
    "message": "No partner data available for the client",
    "path": ["applyUrl", "createApplyUrlForEmployers"],
    "extensions": {
      "subCode": "PARTNER_DATA_NOT_FOUND",
      "code": "BAD_USER_INPUT"
    }
  }]
}

INTERNAL_SERVER_ERROR

INTERNAL_SERVER_ERROR

code	INTERNAL_SERVER_ERROR
Summary	An issue occurred with the Indeed Apply service.

To resolve:

1. Retry the request.
2. If the error persists after several attempts, contact Indeed.

AWI JavaScript errors

These errors are specific to the Apply with Indeed (AWI) JavaScript integration.

AWI JavaScript errors

Error	Cause	Resolution
sourceJobPostingId is not found	Incorrect input for sourceJobPostingId.	Double-check the sourceJobPostingId in your request.
Missing/empty or invalid parameters	A required parameter (sourceJobPostingId, encryptedFeedUrl, partnerApiToken, or encryptedJobUrl) is missing or invalid.	Provide the required parameters correctly. See Specify parameters.
No partner data available for the client	Partner API Token is not registered or incorrect. An OAuth Token might have been sent instead of the partnerApiToken.	Contact Indeed to register the partner API token. If already registered, verify the token is correct.
Partner is not allowed to use this method	Partner API token is registered, but AWI is not enabled.	Contact Indeed to enable Apply with Indeed.
Hex string length must be a multiple of 2	The provided hex string is incorrectly sized for encrypted parameters.	Verify the hex string length is a multiple of 2. See Specify parameters.

Retry strategy

Retryable errors

Error	Retryable?	Strategy
INTERNAL_SERVER_ERROR	Yes	Exponential backoff
GRAPHQL_PARSE_FAILED	No	Fix the query syntax
BAD_USER_INPUT	No	Fix the request based on the subCode

If a request fails and you do not receive a URL, retry the request without showing the Apply with Indeed button. When you receive a URL, enable the button again.

Get support

If you encounter issues not covered in this guide:

1. Check the GraphQL error message, extensions.code, and extensions.subCode fields.
2. Verify all required parameters are present and correctly formatted.
3. Contact your Indeed representative.

See also:

• Troubleshoot GraphQL errors
• Troubleshoot OAuth errors
• Error reference

 

Was this page helpful?