redirect_uri with query parameters indicating the result.
Callback parameters
Status values
success
First-time consent granted. This user has connected their data for the first time with your application.
reauthorized
User re-linked an existing consent. This happens when:
- User clicks the link again after previously consenting
- User re-authenticates after token expiration
failure
User cancelled or an error occurred during the flow.
Error codes
Handling callbacks
State verification
Recommended state storage
What happens after success
When you receivesuccess or reauthorized:
- Data export starts automatically - Emerge begins exporting the user’s data from their provider
- Export takes 1-15 minutes - Depending on data volume
- Webhook updates (optional) - You may receive consent events plus
data.ready/data.failedfor provider-level export updates - Poll export readiness (recommended fallback) - Check
GET /export/status/{uid}and query only when the provider insources[]hasdata_ready: true
Use provider-level readiness from
sources[] instead of assuming all providers are ready at once.Completed session handling
If a user clicks a consent link after they’ve already completed consent:- They see a brief “already connected” message
- They’re redirected to the Data Wallet (not back to your
redirect_uri) - No new callback is triggered