> For the complete documentation index, see [llms.txt](https://threadly.gitbook.io/threadly/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://threadly.gitbook.io/threadly/integrations/planhat.md).

# Planhat

Planhat is a customer success platform that centralizes customer health data, lifecycle stages, and engagement signals. By connecting Planhat to Threadly, you can build **Dynamic Conversation Groups** that automatically include the right Slack channels based on your Planhat CRM data.

***

## What You Can Do

| Use Case                      | Example                                                              |
| ----------------------------- | -------------------------------------------------------------------- |
| Target at-risk accounts       | Build a group of channels where the Planhat health score is below 40 |
| Reach renewal-ready customers | Filter channels where the renewal date is within 60 days             |
| Segment by lifecycle stage    | Send to all channels tagged as "Onboarding" in Planhat               |
| Personalize by account size   | Target enterprise accounts vs. SMB accounts separately               |

***

## Setup

1. In Threadly, go to **Settings → Integrations**.
2. Find **Planhat** and click **Connect**.
3. Enter your **Planhat API credentials** (API key and Tenant UUID from your Planhat account settings).
4. Click **Authorize**.

Once connected, Planhat data becomes available as a filter source when creating Dynamic Conversation Groups.

***

## Creating a Planhat-Filtered Group

See [Planhat Segments](/threadly/groups/dynamic-conversation-groups/planhat-segments.md) for a step-by-step guide to building Dynamic Groups using your Planhat data.

***

## Frequently Asked Questions

**How often does Threadly sync with Planhat?** Group membership is evaluated when you send a message or when a workflow runs. Threadly pulls the latest data from Planhat at that moment, so your groups always reflect current customer data.

**What Planhat properties can I filter on?** Health score, lifecycle stage, renewal date, ARR, and any custom properties you've configured in Planhat.

**Do I need a Planhat admin account to connect?** You need API access credentials from Planhat. Generating an API key typically requires an admin or operations role in Planhat.

***

## See Also

* [Planhat Segments](/threadly/groups/dynamic-conversation-groups/planhat-segments.md) — build Dynamic Groups with Planhat data
* [Dynamic Conversation Groups](/threadly/groups/dynamic-conversation-groups.md) — overview of dynamic groups
* [HubSpot Integration](/threadly/integrations/hubspot.md) — CRM integration for HubSpot users
* [Attio Integration](/threadly/integrations/attio.md) — CRM integration for Attio users


---

# 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, and the optional `goal` query parameter:

```
GET https://threadly.gitbook.io/threadly/integrations/planhat.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.