Why aren't workbooks created when creating a space via API?

Last updated: October 3, 2025

Workbooks Not Created with API Space Creation Endpoint

When creating spaces through the Flatfile API, workbooks may not be automatically created even when listeners are configured

Symptoms

  • Workbooks are created successfully when creating spaces through the Flatfile UI

  • Workbooks are not created when creating spaces via the API

  • No error messages appear in console or network logs

Possible Causes

  • Listener is configured for space:configure event instead of space:created

  • API space creation does not emit space:configure event by default

Solutions

Solution 1: Enable autoConfigure in API Request

When creating a space via the API, set the autoConfigure parameter to true in your request body. This will ensure that the space:configure event is emitted, triggering your workbook creation listener.

You can find detailed information about this parameter in the API reference documentation.

When to Contact Support

If the above solution does not resolve the issue, please contact our support team with the following information:

  • Your space IDs (both working and non-working examples)

  • Your API request configuration

  • Any error messages from your console or network logs