---
title: "V2: Opportunities (Bulk Update)"
description: "V2: Opportunities (Bulk Update)"
---

[Skip to content](https://nexusengage.com/support/v2-opportunities-bulk-update#main-content)

English

Show submenu for translations

![fb2acfcb-b621-467c-ac7f-d5d4beee378d-1](https://nexusengage.com/hs-fs/hubfs/fb2acfcb-b621-467c-ac7f-d5d4beee378d-1.png?width=200&height=53&name=fb2acfcb-b621-467c-ac7f-d5d4beee378d-1.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Nexus Website](https://nexuscenter.io/)

[Nexus Website](https://nexuscenter.io/)

 What are you looking for?

- There are no suggestions because the search field is empty.

1. [Nexus Support Center](https://nexusengage.com/support)
2. [Engagement Hub](https://nexusengage.com/support/engagement-hub)
3. [API](https://nexusengage.com/support/engagement-hub#api)

# V2: Opportunities (Bulk Update)

### **Description**

Updates all opportunities that match search criteria. CRM Opportunity ID and latest opportunity data is passed in.

### HTTP Method

`put`

### URL

```
/api/v2/opportunities/search
```

#### Parameters

| Parameter | Type | Location | Required | Description |
| --- | --- | --- | --- | --- |
| LanguageId | integer | Query | No | Language ID for localized content (default: 1) |

#### Request Body Structure

```
{  "SearchCriteria": {    "OpportunityIds": ["string"]  },  "UpdateRequest": {    "OpportunityName": "string",    "OpportunityID": "string",     "CategoryName": "string",    "StageName": "string",    "AcctPotential": 0.00,    "SalesRevenue": 0.00,    "PendingCloseDate": "2024-12-31"  }}
```

#### Request Body Fields

**SearchCriteria Object**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| OpportunityIds | string\[\] | Yes | Array of CRM opportunity IDs to update |

**UpdateRequest Object**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| OpportunityName | string | No | Name/title of the opportunity |
| OpportunityID | string | No | External CRM opportunity identifier |
| CategoryName | string | No | Category name (must match existing category) |
| StageName | string | No | Stage name (must match existing stage) |
| AcctPotential | decimal | No | Account potential value |
| SalesRevenue | decimal | No | Expected sales revenue |
| PendingCloseDate | string | No | Expected close date (format: yyyy-MM-dd) |

#### Request Examples

```
# Bulk update opportunities by CRM IDPUT /api/v2/opportunities/search?LanguageId=1Authorization: Bearer {your-token}Content-Type: application/json{  "SearchCriteria": {    "OpportunityIds": ["CRM-001", "CRM-002", "CRM-003"]  },  "UpdateRequest": {    "StageName": "Qualified",    "AcctPotential": 100000.00  }} 
```

```
# Update specific opportunity by CRM IDPUT /api/v2/opportunities/searchAuthorization: Bearer {your-token}Content-Type: application/json{  "SearchCriteria": {    "OpportunityIds": ["SFDC-12345"]  },  "UpdateRequest": {    "OpportunityName": "Enterprise Software License",    "CategoryName": "Software",    "StageName": "Proposal",    "AcctPotential": 500000.00,    "SalesRevenue": 250000.00,    "PendingCloseDate": "2024-06-30"  }}
```

#### Response Structure

**Success Response (200 OK)**

```
{  "Opportunity": [    {      "Type": "Pre",      "ID": 123,      "VisitID": 456,      "CustomerID": 789,      "OpportunityName": "Enterprise Software License",      "OpportunityID": "SFDC-12345",      "OpportunityCategoryID": 1,      "OpportunityStageID": 3,      "OpportunityCompetitorID": null,      "AcctPotential": 500000.00,      "SalesRevenue": 250000.00,      "PendingCloseDate": "2024-06-30",      "VisitCustomerOpportunityID": null,      "FollowUpSentDate": null    }  ],  "AvailableCategories": null,  "AvailableStages": null,  "ValidationMessage": null}
```

#### Response Codes

| Code | Description | Response Type |
| --- | --- | --- |
| 200 | Success | V2OpportunityUpdateBulkResponse |
| 400 | Bad Request / Validation Error | V2OpportunityInvalidResponse |
| 401 | Not Authorized | string |
| 500 | Internal Server Error | InternalServerErrorResponse |

- [Engagement Hub](https://nexusengage.com/support/engagement-hub#main-content)

    - [Release Notes](https://nexusengage.com/support/engagement-hub#release-notes)
    - [Dashboard and Calendar](https://nexusengage.com/support/engagement-hub#dashboard-and-calendar)
    - [Visit Requests and Form](https://nexusengage.com/support/engagement-hub#visit-requests-and-form)
    - [Visit Scheduling and Management](https://nexusengage.com/support/engagement-hub#visit-scheduling-and-management)
    - [Site and Room Administration](https://nexusengage.com/support/engagement-hub#site-and-room-administration)
    - [User Management and Profiles](https://nexusengage.com/support/engagement-hub#user-management-and-profiles)
    - [System Configurations](https://nexusengage.com/support/engagement-hub#system-configurations)
    - [API](https://nexusengage.com/support/engagement-hub#api)
    - [Domain](https://nexusengage.com/support/engagement-hub#domain)
    - [Topics/Agenda](https://nexusengage.com/support/engagement-hub#topics-agenda)
    - [Global Settings](https://nexusengage.com/support/engagement-hub#global-settings)
    - [Visit Types](https://nexusengage.com/support/engagement-hub#visit-types)
    - [Admin](https://nexusengage.com/support/engagement-hub#admin)
    - [Communication](https://nexusengage.com/support/engagement-hub#communication)
    - [Visit Management](https://nexusengage.com/support/engagement-hub#visit-management)
    - [Artificial Intelligence (AI)](https://nexusengage.com/support/engagement-hub#artificial-intelligence-ai)
    - [Availability](https://nexusengage.com/support/engagement-hub#availability)
    - [Visit List](https://nexusengage.com/support/engagement-hub#visit-list)
    - [Exports](https://nexusengage.com/support/engagement-hub#exports)
    - [Export](https://nexusengage.com/support/engagement-hub#export)
    - [Requestor](https://nexusengage.com/support/engagement-hub#requestor)
    - [FAQ](https://nexusengage.com/support/engagement-hub#faq)
    - [Login Access](https://nexusengage.com/support/engagement-hub#login-access)
    - [Coordinator](https://nexusengage.com/support/engagement-hub#coordinator)
    - [Visit Status](https://nexusengage.com/support/engagement-hub#visit-status)
    - [Individual Time Block](https://nexusengage.com/support/engagement-hub#individual-time-block)
    - [Navigation](https://nexusengage.com/support/engagement-hub#navigation)
    - [Itinerary](https://nexusengage.com/support/engagement-hub#itinerary)
    - [Invitation](https://nexusengage.com/support/engagement-hub#invitation)
    - [Speakers](https://nexusengage.com/support/engagement-hub#speakers)
    - [Off-Site](https://nexusengage.com/support/engagement-hub#off-site)
    - [Survey](https://nexusengage.com/support/engagement-hub#survey)
    - [Attendee](https://nexusengage.com/support/engagement-hub#attendee)
    - [Support](https://nexusengage.com/support/engagement-hub#support)
- [Sales Enablement Hub](https://nexusengage.com/support/sales-enablement-hub#main-content)

    - [Dynamics Application](https://nexusengage.com/support/sales-enablement-hub#dynamics-application)
    - [Salesforce Application](https://nexusengage.com/support/sales-enablement-hub#salesforce-application)
    - [Release Notes](https://nexusengage.com/support/sales-enablement-hub#release-notes)
- [Experience Hub](https://nexusengage.com/support/experience-hub#main-content)

    - [Customer Portal](https://nexusengage.com/support/experience-hub#customer-portal)
    - [Onsite Channels](https://nexusengage.com/support/experience-hub#onsite-channels)
    - [Program Site](https://nexusengage.com/support/experience-hub#program-site)
    - [Content Management](https://nexusengage.com/support/experience-hub#content-management)
    - [Analytics](https://nexusengage.com/support/experience-hub#analytics)
    - [Nexus Experience Hub Single Sign On](https://nexusengage.com/support/experience-hub#nexus-experience-hub-single-sign-on)
    - [Content Chapters](https://nexusengage.com/support/experience-hub#content-chapters)
    - [Door Monitor](https://nexusengage.com/support/experience-hub#door-monitor)
    - [Media](https://nexusengage.com/support/experience-hub#media)
    - [Home Screen](https://nexusengage.com/support/experience-hub#home-screen)

[![Nexus-Logo](https://nexusengage.com/hs-fs/hubfs/Nexus-Logo.jpg?width=143&height=50&name=Nexus-Logo.jpg "Nexus-Logo")](http://www.signet.tv)

Nexus Help Center

 Contact Nexus Support: [support@nexuscenter.io](mailto:support@nexuscenter.io) 

Copyright © 2025, Nexus

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://nexusengage.com/#organization",
  "@type" : "Organization",
  "description" : "AI-powered customer engagement platform for enterprise teams.",
  "knowsAbout" : [ "Customer Engagement", "Briefing Programs", "Customer Experience", "Sales Enablement", "Executive Briefings", "Customer Advocacy" ],
  "logo" : {
    "@type" : "ImageObject",
    "height" : 32,
    "url" : "https://nexusengage.com/hubfs/raw_assets/public/nexus-theme/images/theme/nexus-logo.svg",
    "width" : 160
  },
  "name" : "Nexus",
  "sameAs" : [ "https://www.linkedin.com/company/nexus-hub/" ],
  "url" : "https://nexusengage.com"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://nexusengage.com/#website",
  "@type" : "WebSite",
  "inLanguage" : "en",
  "name" : "Nexus",
  "publisher" : {
    "@id" : "https://nexusengage.com/#organization"
  },
  "url" : "https://nexusengage.com"
}
```