MOmonaco
Opportunities

Create an Opportunity

Changed on

Creates a new opportunity associated with an existing account.

post/v1/opportunities/

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/opportunities/
  • Auth
    none declared

Request body

namestring required

Name of the opportunity

account_idstring uuid required

ID of the account to associate the opportunity with

owner_user_idstring uuid nullable

User ID to assign as opportunity owner

stagestring nullable

Pipeline stage key for the opportunity. If omitted, the opportunity is placed in the first stage of the org's pipeline.

estimated_close_datestring nullable

Expected close date (YYYY-MM-DD)

notesstring nullable

Notes about the opportunity

tagsstring[] nullable

List of tag IDs to associate with the opportunity

idempotency_keystring uuid nullable

Client-provided idempotency key to prevent duplicate creation

Example request

{
  "name": "Acme Corp - Enterprise License",
  "stage": "Negotiation",
  "estimated_value": {
    "currency_code": "USD",
    "amount": 50000,
    "amount_precise": 50000.25
  },
  "estimated_close_date": "2025-09-30",
  "notes": "Follow up after Q3 board meeting"
}

Response

Successful Response

Example response

{
  "data": {
    "id": "opp_abc123",
    "account_id": "acc_def456",
    "name": "Acme Corp - Enterprise License",
    "owner": {
      "id": "usr_abc123",
      "first_name": "Jane",
      "last_name": "Smith"
    },
    "stage": "negotiation",
    "estimated_value": {
      "currency_code": "USD",
      "amount": 50000,
      "amount_precise": 50000.25
    },
    "estimated_close_date": "2025-09-30",
    "actual_close_date": "2025-10-15",
    "summary": "Enterprise deal with strong champion. Procurement review in progress.",
    "risks": [
      "Budget constraints",
      "Competing vendor evaluation"
    ],
    "notes": "Follow up after Q3 board meeting",
    "tags": [
      "High Priority"
    ],
    "contact_ids": [
      "550e8400-e29b-41d4-a716-446655440000"
    ],
    "last_activity_at": "2025-08-20T14:30:00Z",
    "updated_at": "2025-08-21T14:30:00Z",
    "created_at": "2025-06-01T09:00:00Z"
  }
}

Changes

  • fc720ada2a81Revision changes
    • info

      added the new optional request property //

    • info

      request property // deprecated

    • info

      added the optional property / to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      response property data/estimated_value/anyOf[subschema #1: EstimatedValue]/amount deprecated