Quick Start

Add Keet Link to Your Product

Keet link uses a series of token exchanges to authenticate your users accounts.

    Step 1: Get a linkToken so that you can initialize a link session for your users

    Step 2: Make Keet Link appear in your frontend using the linkToken

    Step 3: Swap the publicToken, returned by keetLink for an accountToken

    Step 4: Use the accountToken for future requests to authenticated sessions.

Step 1: Get a Link Token (Server side)

In your backend, set up a POST request to initialize a Keet Link session and get a linkToken from this URL: https://api.trykeet.com/v1/link/token

1
curl -X POST https://api.trykeet.com/v1/link/token \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json" \
4
     -d '{
5
  "linkConfig": {
6
    "endUserId": "<userId>",
7
    "integration": "Instagram",
8
    "companyLogoUri": "https://example.com/logo.png"
9
  }
10
}'

1
{
2
  "status": "ok",
3
  "linkToken": "<token>"
4
}

You can now pass this public linkToken back to your client to initialize the link component.

Step 2: Make the Keet Link Appear (Client side)

1
  import { useKeetLink } from "@keet-tech/react-keet-link"
2
  import { useEffect, useState } from "react"
3
4
  export default function App() {
5
    const { open, isReady } = useKeetLink({
6
      linkToken: "ADD YOUR LINK TOKEN -- SEE STEP 1",
7
      onSuccess
8
      onValidationError
9
    })
10
11
    const onSuccess = (publicToken: string) => {
12
      /* send a request to your backend
13
      to exchange this for an account token */
14
    }
15
16
    const onValidationError = (errors: any) => {
17
      console.error("An error from Keet Link occured: ", errors)
18
    }
19
20
    return (
21
      <button disabled={!isReady} onClick={open}>Open Link</button>
22
    )
23
  }
24
25
  export default App;

Step 3: Swap publicToken for accountToken (Server Side)

In your backend, create a request to exchange the short-lived publicToken for a permanent accountToken.

1
curl -X POST https://api.trykeet.com/v1/linked-accounts/token \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json" \
4
     -d '{
5
  "publicToken": "..."
6
}'

1
{
2
  "status": "ok",
3
  "accountToken": "acc_..."
4
}

You’re done!

Use the accountToken to make all future requests on behalf of the user to every integration they use.

Check out how to use your integrations