# Common Issues

## Connection issues

<details>

<summary>Authentication fails when entering API credentials</summary>

Double-check that you're using the **Client ID** and **Client Secret** from a Box app configured with **Client Credentials Grant (CCG)**. Apps using OAuth 2.0 user authentication won't work here. Make sure the app has been authorized by your Box enterprise admin if you're accessing enterprise-level data.

</details>

<details>

<summary>The data flow runs but returns no data</summary>

This usually means the User ID is missing or incorrect. The **User ID** field tells Coupler.io which Box account to authenticate as. Verify the ID in your Box developer console under your app's service account details. Without a valid User ID, the connection may succeed but return empty results.

</details>

## Missing data

<details>

<summary>Admin logs or Events entity returns no rows</summary>

Admin logs and Events are only available on **Box Enterprise** plans. If your account is on a lower tier, these entities won't return data. Also confirm that your Box app has the `manage_enterprise` or `admin_readwrite` scope enabled — without it, the API call will succeed but return nothing.

</details>

<details>

<summary>Sign requests or Sign templates are empty</summary>

Box Sign must be enabled on your account. If your organization hasn't activated Box Sign, these entities will return no data. Check with your Box admin to confirm Sign is part of your subscription.

</details>

<details>

<summary>Trashed items aren't showing up</summary>

Trashed items are only visible within Box's retention window — once permanently deleted, they can't be retrieved via the API. If items were purged before your sync ran, they won't appear. Run your data flow more frequently to capture trash contents before purge.

</details>

## Permission errors

<details>

<summary>"Insufficient permissions" error on specific entities</summary>

This means the user specified in the **User ID** field doesn't have access to that entity. For admin-only entities like Admin logs, the User ID must belong to a Box co-admin or admin. For file-level entities, the user must have at least viewer access to the relevant content.

{% hint style="warning" %}
Switching to an admin User ID will broaden data access but may expose sensitive audit data. Confirm with your security team before changing this setting.
{% endhint %}

</details>

<details>

<summary>App not authorized for enterprise access</summary>

Enterprise-scoped entities require your Box app to be explicitly authorized by a Box enterprise admin in the **Admin Console → Apps → Custom Apps**. If authorization is missing, the API returns a permission error even if credentials are correct.

</details>

## Data discrepancies

<details>

<summary>File counts in Coupler.io don't match what I see in Box</summary>

The Box API returns data scoped to the authenticated user. If the User ID belongs to a regular user rather than an admin, only files that user has access to will appear. Switch to an admin-level User ID to get a broader view of all files in the enterprise.

</details>

<details>

<summary>Collaboration roles look different from what's shown in the Box UI</summary>

Box uses internal role labels in the API (e.g., `co-owner`, `editor`, `viewer uploader`) that may differ slightly from what's displayed in the Box web interface. These are accurate API values — refer to Box's API documentation for the full role mapping.

</details>

## Rate limits

<details>

<summary>Sync fails or slows down with large numbers of files or events</summary>

Box enforces API rate limits per app. If you're syncing large entities like Files or Events across a big enterprise, you may hit these limits. Try splitting your data flow into multiple flows per entity rather than pulling everything at once, and avoid running multiple flows simultaneously.

</details>