This article explains how to understand and fix the following TikTok Ads error in Catchr:
An invalid response has been received from the gateway with error code from API = 40002 and status code : 200. Message : Please correct the information in invalid metric fields and try again. Invalid metric fields: ['engagements'].
The most important part of the error is this section:
Invalid metric fields: ['engagements']
This means one of the fields used in the query cannot be combined with the other selected fields.
In most cases, the issue is not that the field is unavailable.
The issue is that TikTok Ads does not allow that field to be queried alongside the other selected metrics or dimensions.
The error message shows the field ID, not the field name shown in the Catchr interface.
So users see:
engagements
But in Catchr, they may only recognize the field by its visible label:
Clicks (All)
As a result, users often do not know which field to remove.
To find the matching field name, check the TikTok Ads field list.
In Catchr's TikTok Ads metrics page:
Clicks (All) is listed
Its field ID is “engagements”
Read the error message carefully and find the field ID listed in Invalid metric fields.
In this example, the invalid field is:
- engagements
Open the TikTok Ads metrics page and search for the field ID.
In this case:
- engagements = Clicks (All)
Once the field is identified, remove it from the query and try again.
If the query works after removing that field, the issue was the field combination.
If your goal is to extract that field, keep it in the query and remove other fields one by one until the query works.
This helps you identify which metric or dimension is incompatible with it.
In practice, the solution is usually:
remove the problematic metric
or remove the incompatible dimension
then rerun the query
A user wanted to query these metrics:
Impressions
Spend
Clicks (All)
With these dimensions:
Campaign
Ad group
Ad
Gender
The query failed because:
Clicks (All) uses the field ID engagements
That field is not compatible with Gender in this query setup
To fix the query, the user has two options:
remove Gender
or remove Clicks (All) and run a separate query for it
When you get this error:
Read the field ID shown in the error
Look up the field ID in the TikTok Ads metrics list
Identify the visible field name
Remove that field and test the query again
If you need the field, remove other fields until you find the incompatible combination
When building TikTok Ads queries with many metrics and dimensions:
Start with a smaller query
Confirm it works
Then add fields progressively
This makes it much easier to identify which field combination causes the error.
This error does not usually mean the field is missing.
It usually means:
The field exists
But TikTok Ads does not allow it to be combined with the other selected fields
In this example:
Engagements is the field ID
The visible field name is Clicks (All)
The resolution is to remove the incompatible field combination and retry the query.