Quickstart

Sign up for free. This quickstart uses GitHub (User OAuth), which is pre-created with integration ID github-getting-started.

If you want to test another API, go to the Integrations tab > Set up new integration > pick an API.

Go to the Connections tab > Add Test Connection > pick your integration, and complete the auth flow. For the GitHub example, pick github-getting-started.

Copy the connection ID and your Tenklo API key from the Environment settings tab > API Keys. For the GitHub example, the integration ID is github-getting-started. You will use these values in the next steps.

Open the github-getting-started integration and select get-repository from the Functions tab.

Tenklo runs the function with the connected account's credentials without exposing them to your app or agent.

Trigger the function from your backend:

import { Nango } from '@nangohq/node';

const nango = new Nango({ apiKey: process.env.NANGO_API_KEY! });

const result = await nango.triggerAction(
    'github-getting-started',
    '<CONNECTION-ID>',
    'get-repository',
    {
        owner: 'NangoHQ',
        repo: 'nango'
    }
);

console.log(result);

You should receive GitHub repository details such as the repository ID, full name, visibility, default branch, and owner.

Open the Logs tab to inspect the function execution, provider request, response, and any errors.

🎉 You connected an API and ran your first integration function.