> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/faq/help-topics/connecting/setting-up-provider-credentials-bring-your-own-keys/whoop-byo-credentials-setup.md).

# How do I set up WHOOP provider credentials?

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](https://docs.tryterra.co/health-and-fitness-api/whoop).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tryterra.co/faq/help-topics/connecting/setting-up-provider-credentials-bring-your-own-keys/whoop-byo-credentials-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.