View as Markdown
Fitbit icon

Fitbit ACTION

Get Heart Rate

Gets the heart rate intraday time series data on a specific date range for a 24 hour period. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Fitbit account once, then configure and run Get Heart Rate from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "fitbit-get-heart-rate",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    fitbit: { authProvisionId: "apn_xxxxxxx" },
    startDate: "Start Date",
    endDate: "End Date",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Heart Rate inputs
Property Type Description
startDate Start Date string
Start date in YYYY-MM-DD format, or today.
Required
endDate End Date string
End date in YYYY-MM-DD format. Defaults to Start Date and must stay within 24 hours of it.
Optional
detailLevel Detail Level string
The granularity of intraday heart rate data points.
Required
startTime Start Time string
Optional. Limit results to a time window starting at this time, in HH:mm format (e.g. 08:00).
Optional
endTime End Time string
Optional. Limit results to a time window ending at this time, in HH:mm format (e.g. 08:30). Requires Start Time.
Optional
timezone Timezone string
Optional. Return data in UTC. Fitbit's heart rate intraday endpoint only supports UTC for this parameter.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
fitbit-get-heart-rate
Version
0.0.2
App
Fitbit
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes