For the complete documentation index, see llms.txt. This page is also available as Markdown.

How do I fix a Whoop 'authorization expired' error?

An 'Authorization expired, please reauthorize with the data provider' error means the provider-side token is no longer valid, usually because the end user…

An 'Authorization expired, please reauthorize with the data provider' error means the provider-side token is no longer valid, usually because the end user revoked your app's access from the provider's portal/app, changed their password, or the provider invalidated or expired the token. Some providers, such as Oura, do not emit a deauth event when this happens.

To fix it, have the user reconnect through your normal Terra connect flow / widget. There is no need to deauthenticate first.

  • Make sure they accept all requested permissions and complete the entire flow without interruption. Data flow then resumes automatically and missing data can be re-pulled. (Providers like Huawei have a rolling lookback window, so reconnecting sooner recovers more history.)

  • For WHOOP specifically, also check the per-key user limit in the WHOOP developer dashboard, as hitting it causes similar failures.

  • Ensure your endpoint returns 2xx to the connection_error webhooks Terra sends, since those are the signal a user needs to reauth.

Last updated

Was this helpful?