Add Preview App

Creates a preview App.
The Deploy App Settings API must be used on the created preview App for the App to become live.
Method POST
URL https://{subdomain}
URL(guest space) https://{subdomain}{SpaceID}/v1/preview/app.json
Authentication Password Authentication
Content-Type application/json


  • Permission to create Apps in the Default App Group is needed.
  • API Tokens cannot be used with this API.

Request Parameters

Parameter Value Required Description
name String Required The App name.
The maximum length is 64 characters.
space Integer   The Space ID of where the App will be created.
thread Integer   The Thread ID of the thread in the Space where the App will be created.
*It is recommended to ignore this parameter so that Apps are created in the default thread. There is currently no helpful reason to create Apps in threads other than the default thread, as there are no visual representations in Kintone of Apps being related to threads. There are only visual representations of Apps being related to Spaces.


The following fields are automatically created with the preview App. These fields will be created in the language set in the user settings of the Kintone user used in the authentication.

  • Record number
  • Created by
  • Updated by
  • Created datetime
  • Updated datetime
  • Status
  • Assignee
  • Category

If the user language setting is set to "Use Web browser settings", the settings set in the Accept-Language header will be used. If there is no Accept-Language header, the language set in the "Localization" settings in the System Administrator's menu will be used.

Sample Request

JavaScript (using Kintone REST API Request)


Response Parameters

Parameter Type Description
app String The App ID of the created preview App.
revision String The revision number of the App settings.

Sample Response

Was this article helpful?
0 out of 0 found this helpful
Do you have any questions or issues related to this article?
Please share your views with us in the Community forums!