Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(integrations): add support for Tapclicks #3052

Merged
merged 5 commits into from
Nov 26, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs-v2/integrations/all/quickbooks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ API configuration: [`quickbooks`](https://nango.dev/providers.yaml), [`quickbook

## API gotchas

- QuickBooks requires a company ID/realmId for each API request. To obtain this when creating a new connection on Nango, go to Settings and select Your Account and Settings. On the Your Account page, your Company ID (found under the Billing & Subscription tab) will be displayed at the top.
- QuickBooks requires a company ID/realmId for each API request. To obtain this when creating a new connection on Nango, go to Settings and select Your Account and Settings. On the Your Account page, your Company ID (found under the Billing & Subscription tab) will be displayed at the top. Nango can automatically retrieve this for you, or you can manually override it by specifying the realmId when creating a new connection.
- You can use [getConnection](/reference/scripts#get-the-connection-credentials) in your integration scripts to retrieve it, or when you fetch the Connection credentials with the REST API or SDK

<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/quickbooks.mdx)</Note>
36 changes: 36 additions & 0 deletions docs-v2/integrations/all/tapclicks.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
title: Tapclicks
sidebarTitle: Tapclicks
---

API configurations: [`tapclicks`](https://nango.dev/providers.yaml)

## Features

| Features | Status |
| - | - |
| [Auth (OAuth)](/integrate/guides/authorize-an-api) | ✅ |
| [Sync data](/integrate/guides/sync-data-from-an-api) | ✅ |
| [Perform workflows](/integrate/guides/perform-workflows-with-an-api) | ✅ |
| [Proxy requests](/integrate/guides/proxy-requests-to-an-api) | ✅ |
| [Receive webhooks](/integrate/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: &lt;48h) |

<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>

## Getting started

- [OAuth related docs](https://apidocs.tapclicks.com/v2/6.27/index.html#section/AUTHENTICATION)
- [Tapclicks REST API docs](https://apidocs.tapclicks.com/v2/6.27/index.html)

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

## API gotchas
- To get started, you need to request your API credentials by filling a form found in the [OAuth2 Client Credentials section](https://apidocs.tapclicks.com/v2/6.27/index.html#section/AUTHENTICATION/oAuth2ClientCredentials)
<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/tapclicks.mdx)</Note>

## Going further

<Card title="Connect to Tapclicks" icon="link" href="/integrations/all/tapclicks/connect" horizontal>
Guide to connect to Tapclicks using Connect UI
</Card>

40 changes: 40 additions & 0 deletions docs-v2/integrations/all/tapclicks/connect.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
---
title: TapClicks - How do I link my account?
sidebarTitle: TapClicks
---


# Overview

To authenticate with TapClicks, you need two key pieces of information:
1. **Client ID** - A unique identifier for your client.
2. **Client Secret** - A confidential key used to authenticate the identity of the application (client).

This guide will walk you through obtaining these credentials within TapClicks.

### Prerequisites:

- You must have an account with TapClicks.

### Instructions:

#### Step 1: Requesting API credentials
1. Access the [OAuth2 Client Credentials section](https://apidocs.tapclicks.com/v2/6.27/index.html#section/AUTHENTICATION/oAuth2ClientCredentials), where you'll find a link to the form. Follow the link to complete the form.

- Once this is done, an email containing the Client ID and Client Secret will be sent within 24-48 hrs, to the email address of the TapClicks super admin user who requested access.

<img src="/integrations/all/tapclicks/request.png" />

#### Step 2: Enter credentials in the Connect UI

Once you have both the **Client ID** and **Client Secret**:
1. Open the form where you need to authenticate with TapClicks.
2. Enter the **Client ID** in the designated field.
3. Enter the **Client Secret** in the Client Secret field.
4. Submit the form, and you should be successfully authenticated.


<img src="/integrations/all/tapclicks/form.png" style={{maxWidth: "450px" }}/>

You are now connected to TapClicks.

Binary file added docs-v2/integrations/all/tapclicks/form.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs-v2/integrations/all/tapclicks/request.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions docs-v2/integrations/analytics.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ sidebarTitle: Analytics
<Card title="Metabase" href="/integrations/all/metabase" color="#68a063" />
<Card title="Mixpanel" href="/integrations/all/mixpanel" color="#68a063" />
<Card title="Segment" href="/integrations/all/segment" color="#68a063" />
<Card title="TapClicks" href="/integrations/all/tapclicks" color="#68a063" />
<Card title="Tableau" href="/integrations/all/tableau" color="#68a063" />
<Card title="People Data Labs" href="/integrations/all/peopledatalabs" color="#68a063" />
<Card title="Typefully" href="/integrations/all/typefully" color="#68a063" />
Expand Down
1 change: 1 addition & 0 deletions docs-v2/integrations/marketing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ sidebarTitle: Marketing
<Card title="Apollo" href="/integrations/all/apollo" color="#68a063" />
<Card title="Pinterest" href="/integrations/all/pinterest" color="#68a063" />
<Card title="Podium" href="/integrations/all/podium" color="#68a063" />
<Card title="TapClicks" href="/integrations/all/tapclicks" color="#68a063" />
<Card title="Sendgrid" href="/integrations/all/sendgrid" color="#68a063" />
<Card title="Segment" href="/integrations/all/segment" color="#68a063" />
<Card title="Sendgrid" href="/integrations/all/sendgrid" color="#68a063" />
Expand Down
1 change: 1 addition & 0 deletions docs-v2/mint.json
Original file line number Diff line number Diff line change
Expand Up @@ -504,6 +504,7 @@
"integrations/all/stripe-app",
"integrations/all/stripe-express",
"integrations/all/survey-monkey",
"integrations/all/tapclicks",
"integrations/all/tableau",
"integrations/all/teamtailor",
"integrations/all/teamwork",
Expand Down
13 changes: 13 additions & 0 deletions packages/shared/providers.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -5665,6 +5665,19 @@ survey-monkey:
base_url: https://api.surveymonkey.com
docs: https://docs.nango.dev/integrations/all/survey-monkey

tapclicks:
display_name: TapClicks
auth_mode: OAUTH2_CC
categories:
- marketing
- analytics
token_url: https://api.tapclicks.com/oauth/accesstoken
token_params:
grant_type: client_credentials
proxy:
base_url: https://api.tapclicks.com/v2
docs: https://docs.nango.dev/integrations/all/tapclicks

tableau:
display_name: Tableau
categories:
Expand Down
1 change: 1 addition & 0 deletions packages/webapp/public/images/template-logos/tapclicks.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading