> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-nan-6306-mcp-tool-connections-get.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Basin

> Integrate your application with the Basin API

## 🚀 Quickstart

Connect to Basin with Nango and see data flow in 2 minutes.

<Steps>
  <Step title="Create the integration">
    In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> *Configure New Integration* -> *Basin*.
  </Step>

  <Step title="Authorize Basin">
    Go to [Connections](https://app.nango.dev/dev/connections) -> *Add Test Connection* -> *Authorize*, then enter your Basin API key. Later, you'll let your users do the same directly from your app.
  </Step>

  <Step title="Call the Basin API">
    Let's make your first request to the Basin API (list forms). Replace the placeholders below with your [secret key](https://app.nango.dev/dev/environment-settings), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):

    <Tabs>
      <Tab title="cURL">
        ```bash theme={null}
        curl "https://api.nango.dev/proxy/v1/forms" \
          -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
          -H "Provider-Config-Key: <INTEGRATION-ID>" \
          -H "Connection-Id: <CONNECTION-ID>"
        ```
      </Tab>

      <Tab title="Node">
        Install Nango's backend SDK with `npm i @nangohq/node`. Then run:

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

        const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

        const res = await nango.get({
            endpoint: '/v1/forms',
            providerConfigKey: '<INTEGRATION-ID>',
            connectionId: '<CONNECTION-ID>'
        });

        console.log(res.data);
        ```
      </Tab>
    </Tabs>

    Or fetch credentials with the [Node SDK](/reference/sdks/node#get-a-connection-with-credentials) or [API](/reference/api/connection/get).

    ✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests.
  </Step>

  <Step title="Implement Nango in your app">
    Follow our [Auth implementation guide](/guides/auth/auth-guide) to integrate Nango in your app.
  </Step>
</Steps>

## 📚 Basin Integration Guides

Nango-maintained guides for common use cases.

* [How do I link my account?](/api-integrations/basin/connect)\
  Find your Basin API key and connect it to Nango

Official docs: [Basin API Reference](https://docs.usebasin.com/developer-features/api-reference/)

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/api-integrations/basin.mdx)</Note>

## 🧩 Pre-built syncs & actions for Basin

Enable them in your dashboard. Extend and customize to fit your needs.

### Others

| Function name                | Description                                                                                              | Type                                           | Source code                                                                                                                      |
| ---------------------------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `create-form-webhook`        | Create a new webhook on a form.                                                                          | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/create-form-webhook.ts)        |
| `create-form`                | Create a new form.                                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/create-form.ts)                |
| `create-project`             | Create a new project.                                                                                    | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/create-project.ts)             |
| `delete-form-webhook`        | Delete a form webhook.                                                                                   | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/delete-form-webhook.ts)        |
| `delete-form`                | Delete a form.                                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/delete-form.ts)                |
| `delete-project`             | Delete a project.                                                                                        | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/delete-project.ts)             |
| `delete-submission`          | Permanently delete a submission.                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/delete-submission.ts)          |
| `get-form-webhook`           | Get a single form webhook by id.                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/get-form-webhook.ts)           |
| `get-form`                   | Get a single form by id.                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/get-form.ts)                   |
| `get-project`                | Get a single project by id.                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/get-project.ts)                |
| `get-submission`             | Get a single submission by id.                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/get-submission.ts)             |
| `list-domains`               | List custom domains configured on this account for branded form/redirect URLs.                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/list-domains.ts)               |
| `list-form-views`            | List Form Views configured on this account.                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/list-form-views.ts)            |
| `list-form-webhooks`         | List webhooks configured across forms in this account.                                                   | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/list-form-webhooks.ts)         |
| `list-forms`                 | List forms in this account.                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/list-forms.ts)                 |
| `list-projects`              | List projects in this account.                                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/list-projects.ts)              |
| `list-submissions`           | List submissions for a form                                                                              | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/list-submissions.ts)           |
| `refire-submission-webhooks` | Re-trigger the configured form webhooks for a single submission (useful for retrying a failed delivery). | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/refire-submission-webhooks.ts) |
| `update-form-webhook`        | Update an existing form webhook.                                                                         | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/update-form-webhook.ts)        |
| `update-form`                | Update fields on an existing form.                                                                       | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/update-form.ts)                |
| `update-project`             | Update a project's name.                                                                                 | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/update-project.ts)             |
| `update-submission`          | Mark a submission as read, spam, and/or trash.                                                           | [Action](/guides/functions/action-functions)   | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/actions/update-submission.ts)          |
| `form_webhooks`              | Sync webhooks configured across forms in this account.                                                   | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/syncs/form_webhooks.ts)                |
| `forms`                      | Sync forms across all projects in this account.                                                          | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/syncs/forms.ts)                        |
| `projects`                   | Sync projects in this account.                                                                           | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/syncs/projects.ts)                     |
| `submissions`                | Sync submissions across all forms in this account                                                        | [Sync](/guides/functions/syncs/sync-functions) | [🔗 Github](https://github.com/NangoHQ/integration-templates/blob/main/integrations/basin/syncs/submissions.ts)                  |

***