Troubleshooting App Builder

<body>
<p id="docs-hc-snippet" style="display: none;">When building apps with AI assistance, you may occasionally encounter syntax errors, unexpected behaviors, or API integration issues. This article provides common troubleshooting techniques and solutions to resolve errors during the app creation and testing processes.</p>
<div class="article-banners">
<div id="docs-wmp-link">
<a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener" target="_blank">What's my plan?</a>
</div>

<div class="article-banner" id="suite_pee">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Professional, Enterprise, or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>

<div class="article-banner" id="support_pe">
<table>
<tbody>
<tr>
<td>
<strong>Support</strong>
</td>
<td>Professional or Enterprise</td>
</tr>
</tbody>
</table>
</div>

</div>

<div class="body">

<p class="p" dir="ltr">When building apps with AI assistance, you may occasionally encounter syntax
errors, unexpected behaviors, or API integration issues. This article provides common
troubleshooting techniques and solutions to resolve errors during the app creation and
testing processes.</p>
<div class="note" id="topic_bcj_zwz_r2c__note_e3s_m4s_mhc">
<span class="notetitle">Note:</span> App Builder uses artificial intelligence to generate code and
configurations based on your inputs. Always thoroughly test apps in a safe environment
before deploying them to production.</div>
<div class="p">This is the fourth and last article in a series on using App Builder:<ul class="ul" id="topic_bcj_zwz_r2c__ul_clg_lvx_gkc">
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9034700691866" target="_blank">Using App Builder</a></li>
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/11141019633050" target="_blank">Creating, publishing, and managing apps with
App Builder</a></li>
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/11140982965914" target="_blank">App Builder code structure
reference</a></li>
<li class="li">Troubleshooting App Builder</li>
</ul>
</div>
<p class="p">This article includes the following sections:</p>
<div class="p">
<ul class="ul" id="topic_bcj_zwz_r2c__ul_jns_lwt_dfc">
<li class="li"><a class="xref" href="#topic_zgm_qb1_s2c">Troubleshooting</a></li>
<li class="li"><a class="xref" href="#topic_vch_dnm_fhc">Disclaimer and maintenance</a></li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_zgm_qb1_s2c">
<h2 class="title topictitle2" id="ariaid-title2">Troubleshooting</h2>
<div class="body">
<p class="p">App Builder may encounter errors that require additional context or information to
resolve. Some examples of these errors include:</p>
<ul class="ul" id="topic_zgm_qb1_s2c__ul_whz_rb1_s2c">
<li class="li">The preview cannot be loaded.</li>
<li class="li">The app cannot be generated or installed.</li>
<li class="li">Integration with a private company system or third-party platform fails.</li>
</ul>
<p class="p">When App Builder encounters issues, it will attempt to resolve them automatically. If
it cannot, it will present you with an error message. Click <strong class="ph b">Show error
details</strong> to view more information about the problem.</p>
<p class="p">To help App Builder diagnose and fix the issue, provide clear and specific details in
your conversation. This may include clarifications, credentials, or any missing
context related to the error. The AI uses this information to better understand the
problem and either resolve it or ask for more details.</p>
<p class="p">For example, if the expected output was a specific data format or a particular
response from the app, but the actual output was different, detailing these
discrepancies will enable App Builder to troubleshoot effectively and suggest
appropriate solutions. The more precise and detailed the feedback, the better the AI
can learn from the interaction and improve its responses in future scenarios.</p>
<p class="p" dir="ltr">When you test your app with live data in your Zendesk instance, such as
fetching or updating records, or integrating with third-party apps, errors may
appear that wouldn’t be visible when using mock data in preview mode. Most apps seem
to function correctly in the Preview tab unless there’s a code compilation issue
that prevents the preview from loading. Guardrail notifications will alert you to
any such errors during testing with real data. If you encounter an error, copy the
details and paste them into the conversation to help App Builder analyze and resolve
the issue.</p>
<div class="p">Here are some common error codes you may encounter:<ul class="ul" id="topic_zgm_qb1_s2c__ul_j3j_1c1_s2c">
<li class="li">
<strong class="ph b">401: Unauthorized Error</strong> - This indicates that the user does not have
the necessary permissions to access the requested resource.</li>
<li class="li">
<strong class="ph b">403: Forbidden Error</strong> - This occurs when a user is logged out of Admin
Center after their session expires while App Builder remains open in their
browser. It can also arise from integration failures.</li>
<li class="li">
<strong class="ph b">404: Not Found Error</strong> - This error signifies a broken or incorrect
URL, or it may indicate that the requested API path is incorrect or
unavailable.</li>
<li class="li">
<strong class="ph b">431: Request Header Fields Too Large</strong> - This error usually occurs
after an extended series of prompts. To resolve it, try clearing the cache
and cookies for the Zendesk app in your browser.</li>
<li class="li">
<strong class="ph b">503: Service Unavailable Error</strong> - This error occurs when the server
receives too many requests, causing it to exceed its resource limits. This
can also happen if the server is down for maintenance or updates.</li>
</ul>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_vch_dnm_fhc">
<h2 class="title topictitle2" id="ariaid-title3">Disclaimer and maintenance</h2>
<div class="body">
<p class="p">Apps created using App Builder are considered non-Zendesk services. You are
responsible for verifying that your app functions as intended and for maintaining it
over time. Zendesk does not guarantee the functionality, support, or continued
maintenance of apps built with App Builder.</p>
</div>
</div>
<script id="docs-schema-markup" type="application/ld+json">{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/11140889487386",
"url": "https://support.zendesk.com/hc/en-us/articles/11140889487386",
"headline": "Troubleshooting App Builder",
"description": "You can troubleshoot errors encountered during app creation and testing by providing detailed information to the AI, which helps diagnose and resolve issues related to syntax, API integration, and permissions.",
"articleSection": "Product help",
"datePublished": "2026-08-17T21:09:48+00:00",
"dateModified": "2026-08-25T21:23:45.462327+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/11140889487386"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
}
}</script>
</body>