> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AskNicely source

> Connect AskNicely to Chartcastr for automated NPS, response volume, and survey funnel charts delivered to Slack or email.

<Info>
  **Paid Feature** — AskNicely is available on Chartcastr paid plans. [See pricing](https://chartcastr.com/pricing).
</Info>

## Overview

Use AskNicely as a data source for Chartcastr. Connect your AskNicely account to turn your NPS programme into scheduled charts: current score, NPS trend, response volume, and survey funnel metrics.

Chartcastr connects with read-only access to the AskNicely REST API using your account subdomain and an API key.

## Setup

<Steps>
  <Step title="Find your subdomain">
    Your AskNicely account lives at a subdomain like `https://acme.asknice.ly`. The subdomain is the part before `.asknice.ly`.
  </Step>

  <Step title="Generate an API key">
    In AskNicely, go to **Settings → API Keys** and generate a new key. Chartcastr passes this via the `X-apikey` request header on every call.
  </Step>

  <Step title="Connect in Chartcastr">
    In Chartcastr, create a new source and choose **AskNicely**. Enter your subdomain and the API key. Chartcastr will validate the connection against `/api/v1/getnps/30` before saving.
  </Step>

  <Step title="Pick a metric">
    Choose the AskNicely metric you want to track. Each metric becomes its own source you can route to Slack or email on any schedule.
  </Step>
</Steps>

## Available Metrics

<CardGroup cols={3}>
  <Card title="NPS" icon="gauge">
    Current 30-day NPS score, NPS trend, and promoter / passive / detractor breakdown.
  </Card>

  <Card title="Responses" icon="message-circle">
    Total responses, score-category bucketing, and recent score history.
  </Card>

  <Card title="Stats funnel" icon="line-chart">
    Daily sent / delivered / opened / responded, response rate, and comment rate.
  </Card>
</CardGroup>

<Card title="View all available charts" icon="list" href="/integrations/sources/asknicely/available-charts">
  See the full list of AskNicely metrics with chart types and descriptions.
</Card>

## How the connection works

* **Auth**: API key + subdomain. The API key is encrypted at rest using AES-256-GCM and is never sent to the browser after setup.
* **Base URL**: `https://{subdomain}.asknice.ly`
* **Endpoints used**: `/api/v1/getnps/{days}`, `/api/v1/responses/...`, `/api/v1/stats`
* **Redirects**: Chartcastr follows AskNicely's S3 redirect for large response payloads automatically.

## Disconnecting

Open **Admin → Settings → Sources → AskNicely** and click **Disconnect**. This archives all AskNicely sources for the org and revokes Chartcastr's stored credentials.