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

How do I set up WHOOP provider credentials?

WHOOP is a bring-your-own-credentials provider.

WHOOP is a bring-your-own-credentials provider. You supply the client ID and secret WHOOP issues, not your Terra dashboard credentials.

1. Create a WHOOP app. On the WHOOP developer portal (a regular WHOOP account is needed to log in), create your own app and note the Client ID and Secret.

2. Set up a customer-owned subdomain.

  • Pick a subdomain you own (e.g. whoop.yourdomain.com).

  • Add a CNAME pointing it at Terra's load balancer.

  • Share the subdomain with Terra support so an SSL certificate and validation CNAME can be issued, then add that CNAME to your DNS.

3. Configure the Terra dashboard. Under Connections > Sources > WHOOP, enter your Client ID and Secret, and set the redirect URL to https://whoop.yourdomain.com/auth/whoop/oauth2.

4. Configure the WHOOP developer dashboard. Set the same redirect, plus the webhook URL https://whoop.yourdomain.com/hooks/whoop/push.

Notes:

  • The registered redirect stays fixed. Per-flow (web vs mobile) redirects are passed in the body of the authenticateUser or widget session request.

  • Add the credentials per environment you need.

See the WHOOP setup guide.

Last updated

Was this helpful?