Get Deals Created

Retrieve deals/opportunities created within a time window (default: last 4 hours).

Returns deals whose timestamp (creation time) falls within the specified date range. If neither start_date nor end_date is provided, defaults to a rolling 4-hour window.

Time-based filtering (start_date / end_date):

• Format: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD
• Default window (no params): last 4 hours

Example requests:

• Deals created in the last 4 hours (default): GET /deals/created
• Deals created in the last 7 days: GET /deals/created?start_date=2026-03-22T00:00:00Z&end_date=2026-03-29T23:59:59Z
• Discovery-stage deals created this month: GET /deals/created?start_date=2026-03-01&match_filter_dict={"stage": "discovery"}

Other Query Parameters:

• match_filter_dict (optional): JSON-encoded MongoDB filter for non-date fields. Filterable fields: stage, marketing_source, value_of_sale, account_id, contact_id.

Response: Array of deal objects (same schema as GET /deals).