FAQ

How do I find my Box Folder ID?

Open the folder in Box in your browser. The Folder ID is the number in the URL after /folder/ — for example, in https://app.box.com/folder/123456789, the Folder ID is 123456789. Paste this number into the Folder ID field in Coupler.io.

Can Box Data Extract read files in subfolders?

Yes — enable the Recursive option when setting up your source. With Recursive on, Coupler.io will process files in the specified folder and all nested subfolders. Without it, only files directly in the root folder are processed.

Do I need a special Box plan to use the AI entities?

Yes. The Stream AI ask, Stream AI extract, and Stream AI extract structured entities all rely on Box AI, which requires a Box plan that includes the Box AI add-on. If your account doesn't have Box AI enabled, you'll get an error when running those entities. The Stream text representation entity does not require Box AI and works on standard Box plans.

What file types are supported for text extraction?

Box supports text representation for common document formats including PDF, DOCX, PPTX, XLSX, and TXT. Image-only files (e.g., scanned documents without OCR, PNG, JPG) are generally not supported unless Box's OCR feature has been applied. Files in unsupported formats will be skipped during extraction.

What should I put in the AI prompt fields?

For Ask AI Prompt, write a question you want answered about each document — for example, "What is the total contract value and the expiry date?" For Extract AI Prompt, describe the metadata you want to pull out — for example, "Extract the vendor name, invoice number, and payment due date." Leave these fields empty only if you're using the text representation entity, which doesn't require a prompt.

Can I combine data from multiple Box folders in one destination?

Yes. Add multiple sources in a single Coupler.io data flow — one per folder — and use the Append transformation to merge them into one output table. This is useful when documents are organized by client, project, or time period across different folders.

Can I send extracted Box content to an AI tool like ChatGPT or Claude?

Absolutely. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Cursor, Perplexity, and OpenClaw. You can extract text or AI-generated answers from Box and pipe them directly into one of these tools for further analysis, classification, or summarization.

Why do my AI extract results change between runs?

Box AI responses can vary slightly between calls even for the same document and prompt — this is a characteristic of large language models. If you need stable, repeatable output, use Stream AI extract structured folders with a well-defined field schema, which constrains the output format and reduces variability.

For details on available fields and entity output schemas, see the Data Overview page. For help with connection errors or missing files, visit Common Issues.