Tools
Users and connect links
Register your users and let them connect their own apps.
How it works
- Register each user once with your own id for them (POST /external-users, needs users:write).
- Create a connect link for one app (POST /connect-sessions). It is valid for 10 minutes.
- Send the returned url to the user. They sign in to the app there.
- The connection is stored for that user and project. List or remove it with /v1/connections.
# 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" }'