Documentation Index
Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
Use this file to discover all available pages before exploring further.
🚀 Quickstart
🧑💻 OAuth app setup
🔗 Useful links
🚨 API gotchas
Create an integration
In Nango (free signup), go to Integrations -> Configure New Integration -> Kintone. Nango doesn’t provide a test OAuth app for Kintone yet. You’ll need to set up your own by following these instructions. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Nango. Authorize Kintone
Go to Connections -> Add Test Connection -> Authorize, then log in to Kintone. Later, you’ll let your users do the same directly from your app. Call the Kintone API
Let’s make your first request to the Kintone API (fetch records from an app). Replace the placeholders below with your secret key, integration ID, and connection ID:curl "https://api.nango.dev/proxy/k/v1/record.json?app={appId}" \
-H "Authorization: Bearer <NANGO-SECRET-KEY>" \
-H "Provider-Config-Key: <INTEGRATION-ID>" \
-H "Connection-Id: <CONNECTION-ID>"
Install Nango’s backend SDK with npm i @nangohq/node. Then run:import { Nango } from '@nangohq/node';
const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });
const res = await nango.get({
endpoint: '/k/v1/record.json',
params: {
app: {appId}
}
providerConfigKey: '<INTEGRATION-ID>',
connectionId: '<CONNECTION-ID>'
});
console.log(JSON.stringify(res.data, null, 2));
Replace {appId} with the actual ID of the Kintone app you want to fetch records from. You can find the app ID in your Kintone app’s URL: https://{subdomain}.kintone.com/k/{appId}/
Create a new OAuth Client
- Log in to your Kintone account, click the gear icon on the upper right menu of Kintone and select User & System Administration.
- From the left navbar, go to System Administration > Integrations, and click on OAuth.
- Fill in all the required information. For Redirect endpoint enter
https://api.nango.dev/oauth/callback.
- Click Save. Your Client ID and Client Secret will be generated automatically. Copy these credentials as you’ll need them when configuring your integration in Nango.
Configure users
In order for a user to use the OAuth client, they must be explicitly granted permission to interact with it. By default, no users have access to a newly created OAuth client.
- Click on Configure users next to your newly created OAuth client.
- From the Configure Users settings screen, select the user(s) who will be able to interact with the client to process the OAuth flow, then click Save.
When new users are created in Kintone, their checkbox for any OAuth client is unchecked by default, meaning the OAuth client is disabled for them until manually enabled.
Common Scopes
| Scope | Description |
|---|
k:app_record:read | Read records and their related data |
k:app_record:write | Create, update, and delete records |
k:app_settings:read | Read app configuration and settings |
k:app_settings:write | Create and update app configuration |
k:file:read | Download files |
k:file:write | Upload files |
- Up to 20 OAuth clients can be registered, and each client can generate up to 10 refresh tokens per user.
