> ## 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

> Authorize an API and run your first Nango function

## AI-assisted quickstart

Copy this prompt into Claude, Cursor, or another coding agent to get guided through signup, API key setup, connection authorization, and your first function call.

<div className="agent-quickstart-actions">
  <button type="button" className="agent-quickstart-action" data-copy-url="https://raw.githubusercontent.com/NangoHQ/skills/main/skills/quickstart/SKILL.md" data-copy-success="Prompt copied">
    <span className="agent-quickstart-action-title">Copy quickstart prompt</span>
    <span className="agent-quickstart-action-description">Paste the quickstart prompt into your coding agent to walk through this guide.</span>
  </button>

  <button type="button" className="agent-quickstart-action" data-copy-text="npx skills add NangoHQ/skills -s quickstart" data-copy-success="Install command copied">
    <span className="agent-quickstart-action-title">Install quickstart skill</span>
    <span className="agent-quickstart-action-description">Copy the command to install <code>quickstart</code> from <code>NangoHQ/skills</code>.</span>
  </button>
</div>

For skills, the docs MCP server, and other agent setup options, see [Coding agent setup](/getting-started/coding-agent-setup).

## Manual quickstart

The steps below show the flow end to end. This quickstart uses the GitHub API as an example, but you can choose any of the [800+ APIs](/integrations/overview).

<Steps>
  <Step id="create-integration" title="Create an integration">
    [Sign up](https://app.nango.dev/signup) 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.
  </Step>

  <Step id="authorize-api" title="Authorize the 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 [Nango API key](/reference/backend/http-api/api-keys) 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.
  </Step>

  <Step id="enable-function" title="Enable an integration function">
    The fastest way to enable a function is to use a template.

    Go to the Integrations tab > open the `github-getting-started` integration > Functions sub-tab. In the functions table, turn on the toggle in the Enable column for `get-repository`.

    This is a Nango Function: it runs provider-specific code with the connected account's credentials, without exposing those credentials to your app or agent.

    <Tip>
      You can also [build a custom function](/guides/functions/functions-guide#build-locally-with-the-cli) in your codebase, or use the [Functions API](/guides/functions/functions-guide#build-with-the-functions-api) to let an agent turn text-defined behavior into deployed function code.
    </Tip>
  </Step>

  <Step id="call-function" title="Call the function">
    Trigger the function from your backend:

    <Tabs>
      <Tab title="Node">
        Install the SDK with `npm i @nangohq/node`, then run:

        ```typescript theme={null}
        import { Nango } from '@nangohq/node';

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

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

        console.log(result);
        ```
      </Tab>

      <Tab title="cURL">
        ```bash theme={null}
        curl --request POST \
          --url https://api.nango.dev/action/trigger \
          --header 'Authorization: Bearer <NANGO-API-KEY>' \
          --header 'Connection-Id: <CONNECTION-ID>' \
          --header 'Provider-Config-Key: github-getting-started' \
          --header 'Content-Type: application/json' \
          --data '{
            "action_name": "get-repository",
            "input": {
              "owner": "NangoHQ",
              "repo": "nango"
            }
          }'
        ```
      </Tab>
    </Tabs>

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

  <Step id="inspect-run" title="Inspect the run">
    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.
  </Step>

  <Step id="choose-next-steps" title="Next steps">
    <CardGroup cols={2}>
      <Card title="Embed auth in your app" icon="lock" href="/guides/auth/auth-guide">
        Let users connect external APIs from your product.
      </Card>

      <Card title="Build custom functions" icon="wand-magic-sparkles" href="/guides/functions/functions-guide">
        Generate, test, customize, and deploy integration code.
      </Card>

      <Card title="Sync external data" icon="arrows-rotate" href="/getting-started/use-cases/syncs">
        Keep external API data fresh for your product or RAG pipeline.
      </Card>

      <Card title="Expose tools to agents" icon="robot" href="/guides/functions/tool-calling">
        Use action functions through tool calling and MCP.
      </Card>
    </CardGroup>
  </Step>
</Steps>

<Tip>**Questions, problems, feedback?** Please reach out in the [Slack community](https://nango.dev/slack).</Tip>