Skip to content
SETU by SUPREME AI
Beta

Connect links

Send your users a link to connect their own apps. Setu keeps the tokens and tells you when a connection breaks.

Get API key

How it works

  1. 1

    Register your user

    Give Setu your own id for them, such as customer_42.

  2. 2

    Create a connect link

    Ask for a link for one app. It is valid for 10 minutes.

  3. 3

    They sign in

    Your user connects the app. Setu stores the connection for that user and project.

Try it

Replace $SETU_API_KEY with a key from the Setu console.

Create a connect link

# 1. Register your user once (your own id for them).
curl https://setu.supremeai.services/api/setu/external-users \
  -H "Authorization: Bearer $SETU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "externalId": "customer_42" }'

# 2. Create a connect link for an app. Send the returned "url" to the user.
#    The link is valid for 10 minutes.
curl https://setu.supremeai.services/api/setu/connect-sessions \
  -H "Authorization: Bearer $SETU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "externalId": "customer_42", "toolkitSlug": "gmail" }'

What it does

  • Connect links for end users.
  • List, check and remove connections by API.
  • A SaaS app where each customer connects their Google account.
  • An agent that asks the user to connect an app the first time it needs it.

Limits and status

Beta
  • Needs the users:write scope.
  • Webhooks tell you when a connection is revoked or needs attention.
  • Not yet: Your own title, logo and colours on the connect page. Coming soon.
  • Not yet: End users created automatically on first use. Coming soon.

Status last checked 2026-10-21.

Questions

Do I store my users’ tokens?

No. Setu keeps them. Your server only keeps your Setu key.

Start building with Setu

No Setu fee during beta. Create a key and make your first call.

Get API key