Skip to main content
When a user connects an app, Constella copies their data in, keeps it up to date, and makes it findable by every search and recall for that user. You never touch an OAuth token.

Notion

Slack

GitHub

Gmail

Google Drive

Google Calendar

A new project starts with no apps turned on. Email us with the apps you need. GET /platform/v1/integrations shows what your project may connect.

Option 1: our hosted page

The quickest way. Constella shows a small page with your app’s name and one Continue button.
1

Add a return link

In Projects, add the https address users come back to. http://localhost works for testing.
2

Make a connect link

3

Send the user to it

The link works for 30 minutes. When they finish, they land on:
status is connected, failed or cancelled. state is what you sent, so you can match it.

Option 2: your own button

Ask for a connect session. You get the app’s own sign-in address (good for about 30 minutes), and open it however you like.
Then wait for the connection.connected webhook, or check the user’s connections.

Know when the data is in

The first sync can take a few minutes for a small account and longer for a big one.
1

connection.connected

The user finished connecting.
2

sync.initial_completed

The first copy is done, with how many items came in.
3

sync.updated

New items arrived. Sent as they come, checked about every 10 minutes.
Or ask any time:

Disconnect

Disconnects the app and forgets what it synced.