---
title: "Link user habit with challenge"
method: POST
path: "/api/v5/challenges/{challenge_id}/user-habits"
tags: ["Challenges"]
---

# Link user habit with challenge

`POST /api/v5/challenges/{challenge_id}/user-habits`

## Request

- Base URL: `https://api.pavlok.com`
- URL: `https://api.pavlok.com/api/v5/challenges/{challenge_id}/user-habits`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/pavlok/apis/pavlok-api-v5/docs/api/v5/challenges/:challenge_id/user-habits/post.ts> (a function with typed inputs; its response is checked against the schema)

Link user habit with challenge

## Path parameters

- `challenge_id` integer, required

## Request body

- BodyChallengesLinkUserHabitsApiV5ChallengesChallengeIdUserHabitsPost
  - `user_habit_ids` ListOfUserHabitsIdsInRequest, required
    - `userHabitIds` integer[], required

## Response `201`

Successful Response

- ListOfChallengeUserHabitsInResponse
  - `challengeUserHabits` ChallengeUserHabit[], required
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `deletedAt` string, date-time
    - `id` integer
    - `challengeId` integer, required
    - `userHabitId` integer, required
    - `status` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pavlok/apis/pavlok-api-v5.md) - [All operations](https://skmtc.dev/pavlok/apis/pavlok-api-v5/llms.txt) - [OpenAPI document](https://skmtc.dev/pavlok/apis/pavlok-api-v5/revisions/3d192098b1ac?raw)