Meta Ads

Meta Updates Ads Insights Async API with Enhanced Error Messaging

January 09, 2026 at 4:41:13 AM

TL;DR Meta is enhancing error reporting for the Ads Insights Async API GET {AD_REPORT_RUN_ID} endpoint to improve developer experience. With Graph API version V25.0 on Feb 18, 2026, detailed error information will be provided for failed asynchronous reports. New fields will include error_code, error_message, error_subcode, error_user_title, and error_user_msg. Developers should ensure compatibility with these updates.

Meta Updates Ads Insights Async API with Enhanced Error Messaging

Meta is enhancing the developer experience with our APIs by improving error reporting for the Ads Insights Async API GET {AD_REPORT_RUN_ID} endpoint. Starting with Graph API version V25.0, set to release on February 18, 2026, developers will receive detailed error information when an asynchronous report fails. This change aims to facilitate easier diagnosis of failures and improve API integration efficiency.

Key Changes

error_code: The error code, changing from uint to int for current users.
error_message: A message corresponding to the error code.
error_subcode: A specific subcode for the error.
error_user_title: A user-friendly title for the error subcode.
error_user_msg: A user-friendly message detailing the error subcode.

These new fields will be included in the response when a report run fails. Developers are encouraged to review their API integration for compatibility with these updates. The changes will be documented in the Graph API Changelog and developer documentation.