> ## Documentation Index > Fetch the complete documentation index at: https://docs.habitify.me/llms.txt > Use this file to discover all available pages before exploring further. # Add a log entry > Create a new log entry for a habit with a specific value and unit. Use this endpoint for measurable habits where you need to record a precise quantity. ## OpenAPI ````yaml https://static.habitify.me/Habitify%20API%20v2.json post /habits/{habitId}/logs openapi: 3.1.1 info: title: Habitify API v2 description: > Welcome to our REST API. Use it to programmatically access your habit tracking data, build integrations, and automate workflows. ## Authentication All endpoints require authentication using an API key passed in the `X-API-Key` header. To generate your API key, open our app and go to **Settings > API**. Only one API key can be active at a time — generating a new key automatically revokes the previous one. > **Note:** API access requires a paid subscription and is not available on the free plan. ### Example Request ``` curl -X GET https://api.habitify.me/v2/habits \ -H "X-API-Key: YOUR_API_KEY" ``` ## Rate Limiting We enforce a rate limit of **500 requests per minute** per account. If you exceed this limit, we will respond with a `429 Too Many Requests` status code. Wait for the rate limit window to reset before making additional requests. ## Versioning This is version 2 of our API. All endpoints are prefixed with `/v2`. version: 2.0.0 contact: name: Habitify API Support url: https://habitify.me license: name: Proprietary url: https://habitify.me/terms servers: - url: https://api.habitify.me/v2 description: Production server security: - ApiKeyTokenAuth: [] - AccessTokenAuth: [] - IdTokenAuth: [] tags: - name: Habits description: Manage your habits — create, update, archive, and delete them x-scalar-order: - habitify-api-v2/tag/habits/GET/habits - habitify-api-v2/tag/habits/POST/habits - habitify-api-v2/tag/habits/GET/habits/journal - habitify-api-v2/tag/habits/GET/habits/{habitId} - habitify-api-v2/tag/habits/PUT/habits/{habitId} - habitify-api-v2/tag/habits/DELETE/habits/{habitId} - habitify-api-v2/tag/habits/POST/habits/{habitId}/archive - habitify-api-v2/tag/habits/GET/habits/{habitId}/statistics - name: Habit Logs description: >- Track your progress by logging completions, failures, skips, and measured values x-scalar-order: - habitify-api-v2/tag/habit-logs/POST/habits/{habitId}/logs - habitify-api-v2/tag/habit-logs/DELETE/habits/{habitId}/logs/{logId} - habitify-api-v2/tag/habit-logs/POST/habits/{habitId}/logs/complete - habitify-api-v2/tag/habit-logs/POST/habits/{habitId}/logs/failed - habitify-api-v2/tag/habit-logs/POST/habits/{habitId}/logs/skipped - habitify-api-v2/tag/habit-logs/POST/habits/{habitId}/logs/undo - name: Habit Notes description: Attach notes with text, mood levels, and photos to your habits x-scalar-order: - habitify-api-v2/tag/habit-notes/GET/habits/{habitId}/notes - habitify-api-v2/tag/habit-notes/POST/habits/{habitId}/notes - habitify-api-v2/tag/habit-notes/PUT/habits/{habitId}/notes/{noteId} - habitify-api-v2/tag/habit-notes/DELETE/habits/{habitId}/notes/{noteId} - name: Areas description: Organize your habits into areas for grouping and categorization x-scalar-order: - habitify-api-v2/tag/areas/GET/areas - habitify-api-v2/tag/areas/POST/areas - habitify-api-v2/tag/areas/GET/areas/{areaId} - habitify-api-v2/tag/areas/PUT/areas/{areaId} - habitify-api-v2/tag/areas/DELETE/areas/{areaId} paths: /habits/{habitId}/logs: post: tags: - Habit Logs summary: Add a log entry description: >- Create a new log entry for a habit with a specific value and unit. Use this endpoint for measurable habits where you need to record a precise quantity. parameters: - name: habitId in: path required: true schema: type: string description: The unique identifier of the habit to log requestBody: required: true content: application/json: schema: type: object required: - unitSymbol - value properties: unitSymbol: description: > Symbol representing the unit of measurement for habit goals and logs. Covers distance, volume, time, weight, energy, and count-based units. type: string enum: - m - kM - ft - yd - mi - floor - L - mL - fl oz - cup - sec - min - hr - ms - kg - g - mg - oz - lb - mcg - J - kJ - kCal - cal - rep - step value: type: number description: The value to log (e.g., 5 for "5 km", 30 for "30 minutes") targetDate: type: string format: date description: >- Date to record the log for (YYYY-MM-DD format). Defaults to today. responses: '201': description: Log entry created successfully content: application/json: schema: type: object properties: message: type: string examples: - Habit log created successfully '400': description: Bad request - invalid input data '401': description: Unauthorized - missing or invalid authentication '404': description: Habit not found '422': description: Validation error - input data failed validation components: securitySchemes: ApiKeyTokenAuth: type: apiKey in: header name: X-API-Key description: >- API key generated from our app (Settings > API). Only one key can be active at a time. AccessTokenAuth: type: http scheme: bearer bearerFormat: JWT description: Access token acquired from OAuth2 IdTokenAuth: type: http scheme: bearer bearerFormat: JWT description: ID token from Firebase Auth ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.