> For the complete documentation index, see [llms.txt](https://docs.buzzy.buzz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buzzy.buzz/troubleshooting/integration-issues.md).

# Integration Issues

Integration issues involve a boundary between Buzzy and another system, or custom logic running inside a Buzzy app.

## Common Symptoms

* REST API request fails authentication or authorization
* API call targets the wrong app, datatable, row, or field
* Code Widget cannot read the current row or expected context
* Buzzy Function fails because inputs, constants, secrets, or external API settings are missing
* external service returns an error or timeout
* runtime UI fails after a custom widget or function change

## First Checks

1. Identify the surface: REST API, Code Widget Async API, Buzzy Function, Custom MCP, or external service.
2. Confirm app ID, datatable ID, field ID, row ID, and environment.
3. Check user permissions and field-level access.
4. Confirm required constants and secrets are configured.
5. If the issue appears in a running app, inspect the affected screen with [In-App Debugging](/troubleshooting/in-app-debugging.md).

## Related Guides

* [API and Extension Surfaces](/developing-and-extending-buzzy/api-and-extension-surfaces.md)
* [REST API Reference](/developing-and-extending-buzzy/buzzy-rest-api/rest-api.md)
* [Code Widget Async API](/the-building-blocks/code-widget-custom-code/new-async-api-+-react-html-components.md)
* [Buzzy Functions](/the-building-blocks/buzzy-functions-and-constants/buzzy-functions.md)
* [Buzzy Custom MCP](/the-building-blocks/mcp/buzzy-custom-mcp.md)