> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useparagon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Dynamics Update Record Opportunity

**Provider API:** Microsoft Dataverse Web API (v9.0).


## OpenAPI

````yaml actionkit/openapi.json POST /projects/{project_id}/tools/#MICROSOFT_DYNAMICS_UPDATE_RECORD_OPPORTUNITY
openapi: 3.0.0
info:
  title: ActionKit Tools API
  version: 1.0.0
servers:
  - url: https://actionkit.useparagon.com
    description: US Cloud
security: []
paths:
  /projects/{project_id}/tools/#MICROSOFT_DYNAMICS_UPDATE_RECORD_OPPORTUNITY:
    post:
      summary: Microsoft Dynamics Update Record Opportunity
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Your Paragon Project ID. You can copy your Project ID from your
              dashboard URL or by clicking Copy Project ID under the Environment
              switcher.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tool:
                  type: string
                  default: MICROSOFT_DYNAMICS_UPDATE_RECORD_OPPORTUNITY
                parameters:
                  type: object
                  properties:
                    actualclosedate:
                      type: string
                      description: >-
                        Shows the date and time when the opportunity was closed
                        or canceled.
                    actualvalue:
                      type: number
                      description: >-
                        Type the actual revenue amount for the opportunity for
                        reporting and analysis of estimated versus actual sales.
                        Field defaults to the Est. Revenue value when an
                        opportunity is won.
                    budgetamount:
                      type: number
                      description: >-
                        Type a value between 0 and 1,000,000,000,000 to indicate
                        the lead's potential available budget.
                    budgetstatus:
                      type: number
                      description: >-
                        Select the likely budget status for the lead's company.
                        This may help determine the lead rating or your sales
                        approach.
                    campaignid:
                      type: object
                      description: >-
                        Shows the campaign that the opportunity was created
                        from. The ID is used for tracking the success of the
                        campaign.
                      properties: {}
                    captureproposalfeedback:
                      type: boolean
                      description: >-
                        Choose whether the proposal feedback has been captured
                        for the opportunity.
                    closeprobability:
                      type: number
                      description: >-
                        Type a number from 0 to 100 that represents the
                        likelihood of closing the opportunity. This can aid the
                        sales team in their efforts to convert the opportunity
                        in a sale.
                    completefinalproposal:
                      type: boolean
                      description: >-
                        Select whether a final proposal has been completed for
                        the opportunity.
                    completeinternalreview:
                      type: boolean
                      description: >-
                        Select whether an internal review has been completed for
                        this opportunity.
                    confirminterest:
                      type: boolean
                      description: >-
                        Select whether the lead confirmed interest in your
                        offerings. This helps in determining the lead quality
                        and the probability of it turning into an opportunity.
                    currentsituation:
                      type: string
                      description: >-
                        Type notes about the company or organization associated
                        with the opportunity.
                    customerid:
                      type: object
                      description: >-
                        Select the customer account or contact to provide a
                        quick link to additional customer details, such as
                        address, phone number, activities, and orders.
                      properties: {}
                    customeridtype:
                      type: object
                      description: CustomerIdType for opportunity
                      properties: {}
                    customerneed:
                      type: string
                      description: >-
                        Type some notes about the customer's requirements, to
                        help the sales team identify products and services that
                        could meet their requirements.
                    customerpainpoints:
                      type: string
                      description: >-
                        Type notes about the customer's pain points to help the
                        sales team identify products and services that could
                        address these pain points.
                    decisionmaker:
                      type: boolean
                      description: >-
                        Select whether your notes include information about who
                        makes the purchase decisions at the lead's company.
                    description:
                      type: string
                      description: >-
                        Type additional information to describe the opportunity,
                        such as possible products to sell or past purchases from
                        the customer.
                    developproposal:
                      type: boolean
                      description: >-
                        Select whether a proposal has been developed for the
                        opportunity.
                    discountamount:
                      type: number
                      description: >-
                        Type the discount amount for the opportunity if the
                        customer is eligible for special savings.
                    discountpercentage:
                      type: number
                      description: >-
                        Type the discount rate that should be applied to the
                        Product Totals field to include additional savings for
                        the customer in the opportunity.
                    emailaddress:
                      type: string
                      description: The primary email address for the entity.
                    estimatedclosedate:
                      type: string
                      description: >-
                        Enter the expected closing date of the opportunity to
                        help make accurate revenue forecasts.
                    estimatedvalue:
                      type: number
                      description: >-
                        Type the estimated revenue amount to indicate the
                        potential sale or value of the opportunity for revenue
                        forecasting. This field can be either system-populated
                        or editable based on the selection in the Revenue field.
                    evaluatefit:
                      type: boolean
                      description: >-
                        Select whether the fit between the lead's requirements
                        and your offerings was evaluated.
                    filedebrief:
                      type: boolean
                      description: >-
                        Choose whether the sales team has recorded detailed
                        notes on the proposals and the account's responses.
                    finaldecisiondate:
                      type: string
                      description: >-
                        Enter the date and time when the final decision of the
                        opportunity was made.
                    freightamount:
                      type: number
                      description: >-
                        Type the cost of freight or shipping for the products
                        included in the opportunity for use in calculating the
                        Total Amount field.
                    identifycompetitors:
                      type: boolean
                      description: >-
                        Select whether information about competitors is
                        included.
                    identifycustomercontacts:
                      type: boolean
                      description: >-
                        Select whether the customer contacts for this
                        opportunity have been identified.
                    identifypursuitteam:
                      type: boolean
                      description: >-
                        Choose whether you have recorded who will pursue the
                        opportunity.
                    initialcommunication:
                      type: number
                      description: >-
                        Choose whether someone from the sales team contacted
                        this lead earlier.
                    isrevenuesystemcalculated:
                      type: boolean
                      description: >-
                        Select whether the estimated revenue for the opportunity
                        is calculated automatically based on the products
                        entered or entered manually by a user.
                    lastonholdtime:
                      type: string
                      description: Contains the date time stamp of the last on hold time.
                    msdyn_forecastcategory:
                      type: number
                      description: Categories used for forecasting.
                    msdyn_gdproptout:
                      type: boolean
                      description: Describes whether opportunity is opted out or not
                    msdyn_opportunitygrade:
                      type: number
                      description: msdyn_OpportunityGrade for opportunity
                    msdyn_opportunitykpiid:
                      type: object
                      description: Maps to opportunity KPI records
                      properties: {}
                    msdyn_opportunityscore:
                      type: number
                      description: msdyn_OpportunityScore for opportunity
                    msdyn_opportunityscoretrend:
                      type: number
                      description: msdyn_OpportunityScoreTrend for opportunity
                    msdyn_ordertype:
                      type: number
                      description: Internal use only.
                    msdyn_predictivescoreid:
                      type: object
                      description: Predictive score
                      properties: {}
                    msdyn_scorehistory:
                      type: string
                      description: msdyn_ScoreHistory for opportunity
                    msdyn_scorereasons:
                      type: string
                      description: msdyn_ScoreReasons for opportunity
                    msdyn_segmentid:
                      type: object
                      description: >-
                        Unique identifier for Segment associated with
                        Opportunity.
                      properties: {}
                    msdyn_similaropportunities:
                      type: string
                      description: msdyn_similaropportunities for opportunity
                    msdyn_workordertype:
                      type: object
                      description: >-
                        Unique identifier for Work Order Type associated with
                        Opportunity.
                      properties: {}
                    name:
                      type: string
                      description: >-
                        Type a subject or descriptive name, such as the expected
                        order or company name, for the opportunity.
                    need:
                      type: number
                      description: >-
                        Choose how high the level of need is for the lead's
                        company.
                    opportunityratingcode:
                      type: number
                      description: >-
                        Select the expected value or priority of the opportunity
                        based on revenue, customer status, or closing
                        probability.
                    originatingleadid:
                      type: object
                      description: >-
                        Choose the lead that the opportunity was created from
                        for reporting and analytics. The field is read-only
                        after the opportunity is created and defaults to the
                        correct lead when an opportunity is created from a
                        converted lead.
                      properties: {}
                    ownerid:
                      type: object
                      description: Owner Id
                      properties: {}
                    owneridtype:
                      type: object
                      description: Owner Id Type
                      properties: {}
                    parentaccountid:
                      type: object
                      description: >-
                        Choose an account to connect this opportunity to, so
                        that the relationship is visible in reports and
                        analytics, and to provide a quick link to additional
                        details, such as financial information and activities.
                      properties: {}
                    parentcontactid:
                      type: object
                      description: >-
                        Choose a contact to connect this opportunity to, so that
                        the relationship is visible in reports and analytics.
                      properties: {}
                    participatesinworkflow:
                      type: boolean
                      description: >-
                        Information about whether the opportunity participates
                        in workflow rules.
                    presentfinalproposal:
                      type: boolean
                      description: >-
                        Select whether the final proposal has been presented to
                        the account.
                    presentproposal:
                      type: boolean
                      description: >-
                        Select whether a proposal for the opportunity has been
                        presented to the account.
                    pricelevelid:
                      type: object
                      description: >-
                        Choose the price list associated with this record to
                        make sure the products associated with the campaign are
                        offered at the correct prices.
                      properties: {}
                    pricingerrorcode:
                      type: number
                      description: Pricing error for the opportunity.
                    prioritycode:
                      type: number
                      description: >-
                        Select the priority so that preferred customers or
                        critical issues are handled quickly.
                    processid:
                      type: string
                      description: >-
                        Contains the id of the process associated with the
                        entity.
                    proposedsolution:
                      type: string
                      description: >-
                        Type notes about the proposed solution for the
                        opportunity.
                    purchaseprocess:
                      type: number
                      description: >-
                        Choose whether an individual or a committee will be
                        involved in the  purchase process for the lead.
                    purchasetimeframe:
                      type: number
                      description: >-
                        Choose how long the lead will likely take to make the
                        purchase.
                    pursuitdecision:
                      type: boolean
                      description: >-
                        Select whether the decision about pursuing the
                        opportunity has been made.
                    qualificationcomments:
                      type: string
                      description: >-
                        Type comments about the qualification or scoring of the
                        lead.
                    quotecomments:
                      type: string
                      description: >-
                        Type comments about the quotes associated with the
                        opportunity.
                    resolvefeedback:
                      type: boolean
                      description: >-
                        Choose whether the proposal feedback has been captured
                        and resolved for the opportunity.
                    salesstage:
                      type: number
                      description: >-
                        Select the sales stage of this opportunity to aid the
                        sales team in their efforts to win this opportunity.
                    salesstagecode:
                      type: number
                      description: >-
                        Select the sales process stage for the opportunity to
                        indicate the probability of closing the opportunity.
                    schedulefollowup_prospect:
                      type: string
                      description: >-
                        Enter the date and time of the prospecting follow-up
                        meeting with the lead.
                    schedulefollowup_qualify:
                      type: string
                      description: >-
                        Enter the date and time of the qualifying follow-up
                        meeting with the lead.
                    scheduleproposalmeeting:
                      type: string
                      description: >-
                        Enter the date and time of the proposal meeting for the
                        opportunity.
                    sendthankyounote:
                      type: boolean
                      description: >-
                        Select whether a thank you note has been sent to the
                        account for considering the proposal.
                    skippricecalculation:
                      type: number
                      description: Skip Price Calculation (For Internal Use)
                    slaid:
                      type: object
                      description: >-
                        Choose the service level agreement (SLA) that you want
                        to apply to the opportunity record.
                      properties: {}
                    stageid:
                      type: string
                      description: >-
                        Contains the id of the stage where the entity is
                        located.
                    statecode:
                      type: number
                      description: >-
                        Shows whether the opportunity is open, won, or lost. Won
                        and lost opportunities are read-only and can't be edited
                        until they are reactivated.
                    statuscode:
                      type: number
                      description: Select the opportunity's status.
                    stepid:
                      type: string
                      description: Shows the ID of the workflow step.
                    stepname:
                      type: string
                      description: >-
                        Shows the current phase in the sales pipeline for the
                        opportunity. 
                    teamsfollowed:
                      type: number
                      description: Number of users or conversations followed the record
                    timeline:
                      type: number
                      description: Select when the opportunity is likely to be closed.
                    timezoneruleversionnumber:
                      type: number
                      description: For internal use only.
                    totalamount:
                      type: number
                      description: >-
                        Shows the total amount due, calculated as the sum of the
                        products, discounts, freight, and taxes for the
                        opportunity.
                    totalamountlessfreight:
                      type: number
                      description: >-
                        Shows the total product amount for the opportunity,
                        minus any discounts. This value is added to freight and
                        tax amounts in the calculation for the total amount of
                        the opportunity.
                    totaldiscountamount:
                      type: number
                      description: >-
                        Shows the total discount amount, based on the discount
                        price and rate entered on the opportunity.
                    totallineitemamount:
                      type: number
                      description: >-
                        Shows the sum of all existing and write-in products
                        included on the opportunity, based on the specified
                        price list and quantities.
                    totallineitemdiscountamount:
                      type: number
                      description: >-
                        Shows the total of the Manual Discount amounts specified
                        on all products included in the opportunity. This value
                        is reflected in the Total Detail Amount field on the
                        opportunity and is added to any discount amount or rate
                        specified on the opportunity.
                    totaltax:
                      type: number
                      description: >-
                        Shows the total of the Tax amounts specified on all
                        products included in the opportunity, included in the
                        Total Amount field calculation for the opportunity.
                    transactioncurrencyid:
                      type: object
                      description: >-
                        Choose the local currency for the record to make sure
                        budgets are reported in the correct currency.
                      properties: {}
                    traversedpath:
                      type: string
                      description: >-
                        A comma separated list of string values representing the
                        unique identifiers of stages in a Business Process Flow
                        Instance in the order that they occur.
                    utcconversiontimezonecode:
                      type: number
                      description: >-
                        Time zone code that was in use when the record was
                        created.
                    entityId:
                      type: string
                      description: Entity ID to perform the operation on
                  required:
                    - customerid
                    - name
                    - entityId
                  x-integration: microsoftDynamics
              required:
                - tool
                - parameters
      responses:
        '200':
          description: >-
            The Dataverse record after the update, as returned by Dataverse. The
            fields depend on the table and the connected environment. Fields
            with a null value are omitted from the example.
          content:
            application/json:
              examples:
                'Success: Updated':
                  summary: Opportunity updated
                  value:
                    '@odata.context': >-
                      https://example.crm.dynamics.com/api/data/v9.0/$metadata#opportunities/$entity
                    '@odata.etag': W/"36693530"
                    totalamount_base: 0
                    pursuitdecision: false
                    totallineitemdiscountamount: 0
                    totalamount: 0
                    identifypursuitteam: false
                    statuscode: 1
                    totaldiscountamount_base: 0
                    _createdby_value: 746951b2-9038-43b3-ac28-16366bf692e3
                    name: Docs Example Opportunity
                    _owninguser_value: 746951b2-9038-43b3-ac28-16366bf692e3
                    totaltax: 0
                    _modifiedby_value: 746951b2-9038-43b3-ac28-16366bf692e3
                    msdyn_ordertype: 192350000
                    identifycustomercontacts: false
                    presentproposal: false
                    captureproposalfeedback: false
                    salesstagecode: 1
                    msdyn_forecastcategory: 100000001
                    sendthankyounote: false
                    _parentaccountid_value: 9310e1a3-f6e4-4e5a-a927-b07bbf75978d
                    totalamountlessfreight: 0
                    _ownerid_value: 746951b2-9038-43b3-ac28-16366bf692e3
                    developproposal: false
                    description: Updated
                    skippricecalculation: 0
                    modifiedon: '2026-10-16T06:21:07Z'
                    totaltax_base: 0
                    opportunityratingcode: 2
                    totallineitemdiscountamount_base: 0
                    stepname: 1-Qualify
                    identifycompetitors: false
                    msdyn_gdproptout: false
                    totallineitemamount: 0
                    _owningbusinessunit_value: a0b74d6c-90de-4c4f-a0e0-bf1888180f2d
                    decisionmaker: false
                    opportunityid: 13f7ed41-d0e2-4711-ad69-8dd33a6e8143
                    totaldiscountamount: 0
                    evaluatefit: false
                    presentfinalproposal: false
                    statecode: 0
                    isrevenuesystemcalculated: false
                    participatesinworkflow: false
                    exchangerate: 1
                    filedebrief: false
                    totalamountlessfreight_base: 0
                    _customerid_value: 9310e1a3-f6e4-4e5a-a927-b07bbf75978d
                    prioritycode: 1
                    _transactioncurrencyid_value: 68f389b0-577b-4f48-aee5-92544c03e41d
                    totallineitemamount_base: 0
                    confirminterest: false
                    completeinternalreview: false
                    completefinalproposal: false
                    resolvefeedback: false
                    createdon: '2026-10-16T06:20:01Z'
                    pricingerrorcode: 0
                    versionnumber: 36693530
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your [Paragon User
        Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which
        you can generate using your project's signing keys.

````