Post Opportunity

Create a new opportunity/deal.

At least one of account_id or contact_id is required to link the deal to an existing account or contact.

Request Body (OpportunityRequest):

• name (required): Opportunity name.
• account_id (optional): FK to an account (company).
• contact_id (optional): FK to a contact (decision maker).
• stage (default: "discovery"): Pipeline stage. Values: draft, prospecting, discovery, developing, negotiation_review, contract_pending, closed_won, closed_lost.
• value_of_sale (optional): Deal amount (float).
• probability_pcnt (optional): Win probability 0–1 (e.g., 0.75 = 75%).
• expected_close_date (optional): Epoch timestamp (seconds).
• marketing_source (optional): Marketing source name.
• business_need_description (optional): Pain points / business need.
• product_dict_list (optional): Array of products, e.g. [{"product_id":"...","unit_amount":50000,"unit_count":1}].

Response: The created deal object.