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.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.
