---
title: "Post Deals Timeline"
method: POST
path: "/reports/deals/timeline"
tags: ["CRM Reports"]
---

# Post Deals Timeline

`POST /reports/deals/timeline`

## Request

- Base URL: `https://fapi.ambivo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://fapi.ambivo.com/reports/deals/timeline`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ambivo/apis/ambivo-api/docs/reports/deals/timeline/post.ts> (a function with typed inputs; its response is checked against the schema)

Deal count + total value bucketed by month/week over the period.

Fetches deals from upstream and buckets in-process (no upstream date-grouping
available yet).

## Request body

- DealsTimelineRequest
  - `start_date` string, required: ISO date string (inclusive)
  - `end_date` string, required: ISO date string (inclusive)
  - `bucket` string
  - `user_id` string, nullable

## Response `200`

Successful Response

- DealsTimelineResponse
  - `points` DealsTimelinePoint[], required
    - `period` string, required
    - `count` integer, required
    - `total_value` number, required
  - `bucket` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-06** `165a6d16a9a0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ambivo/apis/ambivo-api/changes/reports/deals/timeline/post.md)

---

[API](https://skmtc.dev/ambivo/apis/ambivo-api.md) - [All operations](https://skmtc.dev/ambivo/apis/ambivo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ambivo/apis/ambivo-api/revisions/165a6d16a9a0?raw)