Error codes explained

When posting via JobRelay you may see some errors when posting. This post outlines what the errors mean and therefore indicate how to fix any issues.

Error source

JobRelay sends errors from 2 different sources.

  • JobRelay – this means the error has come directly from JobRelay, before the job was “relayed” onto the client website.
  • Client – this means the error was issued by the client website

Errors are always returned as json and look like this:

{
    "status": "error",
    "source": "jobrelay.io",
    "message": "Authorisation failed. An invalid site URL to post the job to was provided."
}

Error messages

401: Authorisation failed errors

A valid subscription ID was not found for the JobRelay service.

This is means that a subscription ID was not passed in the request.

No license key was provided with the feed data.

All requests must pass a license in request. This error indicates this was not present.

No site URL key was provided with the feed data. A valid site URL to post the job to must be provided.

Each request must send the site URL of the site the job should be relayed on to. This error indicates this is not present in the request.

An invalid site URL to post the job to was provided.

This indicates that the site URL sent does not match the site URL which is authorised to have jobs sent to.

This could be that the license has not been authorised on the correct site. Check the list of sites in your JobRelay Purchase History page to make sure the site you are posting too is listed for the license.

There is no active subscription for the subscription ID provided. It is likely that the subscription has lapsed, and needs renewing.

The subscription to JobRelay is either incorrect (the wrong ID) or the subscription has lapsed and needs renewing.

406: Not acceptable errors

No command, or an invalid command was provided. Accepted commands are add, update or delete.

The command sent was not in the list of allowed commands (add, update or delete) or the command was not present in the request.

Job title is missing.

Each job must have a job title and a title was not sent.

Job description is missing.

Each job must have a job description and a title was not sent.

Job reference is missing.

Each job must have a job reference and a title was not sent.

For some reason the job post was not added.

This error comes from the client website and means the job could not be inserted into the WordPress database for some reason. It is thrown when the wp_insert_post function fails for some reason.

A job with the given reference or ID could not be found. Therefore the job could not be deleted.

Usually returned when trying to delete a job that does not exist on the WordPress site. A job with the given reference could not be found on the site.

A job with the given reference or ID exists, however the delete command failed.

This error indicates that the WordPress wp_delete_post command failed when trying to delete a job.