SmartApp troubleshooting

Diagnose connection tests, missing values, repeater mappings, authorization, and stale panels.

Connection test fails

Check the URL, mock dynamic values, configured headers, TLS certificate, status code, response time, and whether the endpoint returns JSON.

A field is missing from the builder

Return it in the test response with the same type used in production. The builder cannot select a property it did not discover.

A repeater is empty or malformed

Confirm the selected property is an array. Use nested repeaters for nested arrays and return [] instead of null when no items exist.

Authorization fails after working previously

Check token expiry and rotation. Update the SmartApp header and connection test together; do not temporarily make the endpoint public.

Data is stale

Review the configured refetch interval and any cache in your endpoint. Keep the callback read-only so an automatic refetch cannot repeat a side effect.