Error Codes for FreeWheel Ad Submissions
The error messages for failed ad submissions can come from either Advertising DSP or from FreeWheel. Error messages are shown in the API Response column in the Freewheel Status dialog.
Advertising DSP Internal Errors
Error Message
Description
Next Steps
Awaiting status response from FreeWheel
FreeWheel hasn’t yet responded that the submission was successful or failed.
Check the status again in 10 minutes.
The submitted ad does not have a clock number assigned.
FreeWheel doesn’t accept UK ads without assigned clock numbers.
Assign a clock number to the ad, and then resubmit the ad.
The ad you are attempting to submit has not yet finished transcoding. Please wait ten minutes then try again.
The transcoder hadn’t finished transcoding the ad when you attempted to submit the ad.
Wait ten minutes, and then resubmit the ad.
The deal id you input is not setup as a guaranteed feed. Please submit guaranteed deals only.
The submitted deal is not set up as a programmatic guaranteed deal. FreeWheel accepts only guaranteed deals.
Set up the deal ID as a programmatic guaranteed deal. The ad is automatically submitted to FreeWheel when you save the programmatic guaranteed default placement at the end of deal ID workflow.
Invalid external_deal_id: <deal_id>
The submitted deal ID either doesn’t exist or isn’t active on the ÃÛ¶¹ÊÓƵ end.
Make sure that the deal is active, and then resubmit the ad.
[public_id=]<deal> does not exist
The submitted deal id doesn’t exist on the FreeWheel end.
Contact your FreeWheel representative to confirm the deal ID.
Ad with identifier <ad name> was not found.
The submitted ad key either doesn’t exist or isn’t active on the ÃÛ¶¹ÊÓƵ end.
Find the correct ad key, and then resubmit the ad.
Pending Submission
The submission is still pending.
Refresh the page.
Freewheel API Errors
Code
Meaning
Description
Next Steps
401
Unauthorized
Incorrect, missing, or invalid access credentials.
Contact your ÃÛ¶¹ÊÓƵ Account Team.
403
Forbidden
The server understood the request but refuses to authorize it.
Contact your ÃÛ¶¹ÊÓƵ Account Team.
404
Not Found
The resource you requested is not available. If the Creative ID is not found in the PUT operation, a 404 is returned.
Contact your ÃÛ¶¹ÊÓƵ Account Team.
405
Method Not Allowed
A request was made of a resource using a request method not supported by that resource (for example, using GET on a method that requires data to be sent by POST, or using PUT on a read-only resource).
Contact your ÃÛ¶¹ÊÓƵ Account Team.
408
Request Timeout
A timeout occurred while this request was processing. Timeouts usually are caused by concurrent requests of exclusive access to certain resources.
Resubmit the request when you receive this status. If the issue persists, contact your ÃÛ¶¹ÊÓƵ Account Team.
422
Unprocessable Entity
Invalid resource. This error happens when the request body is invalid or the created/updated resource is invalid (for example, if the Deal ID was not found). See FreeWheel API 422 Errors for more information.
Contact your ÃÛ¶¹ÊÓƵ Account Team.
500
Internal Server Error
API system error.
Contact your ÃÛ¶¹ÊÓƵ Account Team.
Freewheel API 422 Errors freewheel-422-errors
Code
HTTP Code
Description
DATA_UNMARSHALL_FAILURE
422
The request data is invalid json format. Check the error message for details.
DATA_VALIDATION_FAILURE
422
The request data is missing required fields or has an invalid data type. Check the error message for details.
DATA_DEAL_INVALID
422
The deal is configured incorrectly or doesn’t exist. Check the error message for details.
DATA_DEAL_GET_FAILURE
422
The deal wasn’t found or its configuration has an issue. Check the error message for details.
DATA_CREATIVE_INGEST_FAILURE
422
The creative URL is invalid. Check the error message for details.
DATA_CREATIVE_LINK_FAILURE
422
The creative wasn’t linked to the ad unit nodes of the deal. Check the error message for details.
DATA_CREATIVE_UPDATE_FAILURE
422
The creative wasn’t updated. Check the error message for details.
DATA_DSP_GET_FAILURE
422
The DSP doesn’t exist within the system.
DATA_CREATIVE_UNLINK_FAILURE
422
The creative wasn’t unlinked from ad units.
DATA_CREATIVE_DELETE_FAILURE
422
The creative wasn’t deleted.
DATA_CREATIVE_DETECTION_FAILURE
422
The URL wasn’t detected.
DATA_ENTITY_NOT_FOUND
422
The creative doesn’t exist.
recommendation-more-help
9ff4800f-94be-45f0-a5bf-09d0d7e96baa