Articles in this section

Set up a connection to Kintone

Tanisha Ray
Updated

Kintone is a flexible, cloud-based business application platform that enables companies to easily design custom workflows, forms, and databases.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type * 

Select your Kintone API type:

  • REST: Create, retrieve, update, and delete apps, records, files, and spaces; manage customization, app settings, view layouts, permissions, comments, plugins, and more to automate and extend the Kintone platform.

  • User: Get, add, and update users, departments, and groups. Assign user services, departments, and group memberships to centralize identity and organization management within Kintone.

Subdomain * 

Enter your Kintone subdomain. For example, if your account URL is https://test.kintone.com, then test is your subdomain.

Auth type * 

Select your Kintone auth type (Custom, Token or OAuth 2.0)

App ID * (if API type is REST)

Enter your Kintone app ID.

To find the app ID, navigate to your existing app or create a new app. The App ID appears at the end of the URL in the address bar. For example, if your app URL is https://kintone.com/k/app=57, then 57 is your app ID.

If you create a new app, ensure you assign the new app to your user token.

Auth type: Custom 

Login name *  

Enter your Kintone account login name.

Password *  

Enter your Kintone password.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s password safe. When editing this form later, you must enter this password again; it is stored only when the connection is saved and never displayed as text.

Auth type: Token 

Token * 

Enter your Kintone token.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s token safe. When editing this form later, you must enter this token again; it is stored only when the connection is saved and never displayed as text.

dataLoad.svg​​How to retrieve the token 

Auth type: OAuth 2.0 

OAuth 2.0 client  

Select the OAuth 2.0 client that stores the client ID and client secret provided to you by Kintone.

dataLoad.svg​​ How to retrieve the client ID and secret

To add an OAuth 2.0 client and configure your credentials, click the plus (+ ) button. Click the edit (pencil.svg) button to modify a selected OAuth 2.0 client.

dataLoad.svg​​ How to create OAuth 2.0 client in integrator.io

Note

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see custom, token, and OAuth 2.0 universal connector documentation.

How to retrieve the client ID and client secret

  1. Sign in to your Kintone account.

  2. Navigate to Settings > Users and system administration > Integrations > API tokens.

  3. Click Generate API token.

  4. Enter an Overview and select the Scopes.

  5. Click Generate.

  6. Copy the API token.

How to retrieve the token

API type: User 

  1. Sign in to your Kintone account.

  2. Navigate to  Settings > Users and system administration > Integrations > OAuth.

  3. Click Add OAuth client.

  4. Provide a Client name.

  5. Paste the integrator.io redirect URL in the Redirect endpoint.

    • For NA: paste https://integrator.io/connection/oauth2callback

    • For EU: paste https://eu․integrator.io/connection/oauth2callback

  6. Click Save. You will be redirected to the OAuth page.

  7. From the available clients, click Edit.

  8. Copy the Client ID

  9. Copy the Client secret.

API type: REST 

  1. Sign in to your Kintone account.

  2. Navigate to App settings > Customization and integration >API token.

  3. Click Generate.

  4. Check the Permissions.

  5. Copy the API token. For detailed information, see API tokens.

Additional references