Create or modify an offer
Note
The Cloud Partner Portal APIs are integrated with and will continue working in Partner Center. The transition introduces small changes. Review the changes listed in Cloud Partner Portal API Reference to ensure your code continues working after transitioning to Partner Center. CPP APIs should only be used for existing products that were already integrated before transition to Partner Center; new products should use Partner Center submission APIs.
This call updates a specific offer within the publisher namespace or creates a new offer.
PUT https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>?api-version=2017-10-31
URI parameters
| Name | Description | Data type |
|---|---|---|
| publisherId | Publisher identifier, for example contoso |
String |
| offerId | Offer identifier | String |
| api-version | Latest version of the API | Date |
Header
| Name | Value |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer YOUR_TOKEN |
Uploading artifacts
Artifacts, such as images and logos, should be shared by uploading them to an accessible location on the web, then including each as a URI in the PUT request. The system will detect that these files aren't present in Azure Marketplace storage and download them. As a result, you will find that future GET requests will return an Azure Marketplace service URL for these files.
Categories and industries
When creating a new offer, you must specify a category for your offer in the marketplace. Optionally, for some offer types you can also specify industries. Based on the offer type, provide the categories/industries applicable to the offer using specific key values from the following tables.
Azure Marketplace categories
These categories and their respective keys are applicable for Azure apps, Virtual Machines, Core Virtual Machines, Containers, Container apps, IoT Edge modules, and SaaS offer types. Items in bold italic (like analytics) are categories and standard text items (like data-insights) are subcategories below them. Use the exact key values, without changing spacing or capitalization.
| Category | SaaS keys | Azure App keys | Virtual Machine, Containers, Container apps, IoT Edge Module, Core Virtual Machine keys |
|---|---|---|---|
| Analytics | analytics | analytics-azure-apps | analytics-amp |
| Data Insights | data-insights | data-insights | data-insights |
| Data Analytics | data-analytics | data-analytics | data-analytics |
| Big Data | big-data | bigData | big-data |
| Predictive Analytics | predictive-analytics | predictive-analytics | predictive-analytics |
| Real-time/Streaming Analytics | real-time-streaming-analytics | real-time-streaming-analytics | real-time-streaming-analytics |
| Other | other | other-analytics | other |
| AI + Machine Learning | ArtificialIntelligence | ai-plus-machine-learning | ai-plus-machine-learning |
| Bot Services | bot-services | bot-services | bot-services |
| Cognitive Services | cognitive-services | cognitive-services | cognitive-services |
| ML Service | ml-service | ml-service | ml-service |
| Automated ML | automated-ml | automated-ml | automated-ml |
| Business/Robotic Process Automation | business-robotic-process-automation | business-robotic-process-automation | business-robotic-process-automation |
| Data Labelling | data-labelling | data-labelling | data-labelling |
| Data Preparation | data-preparation | data-preparation | data-preparation |
| Knowledge Mining | knowledge-mining | knowledge-mining | knowledge-mining |
| ML Operations | ml-operations | ml-operations | ml-operations |
| Other | other-AI-plus-machine-learning | other | other |
| Blockchain | blockchain | blockchain | blockchain |
| App Accelerators | app-accelerators | app-accelerators | app-accelerators |
| Single-node Ledger | single-node-ledger | single-node-ledger | single-node-ledger |
| Multi-node Ledger | multi-node-ledger | multi-node-ledger | multi-node-ledger |
| Tools | tools | tools | tools |
| Other | other | other | other |
| Compute | compute-saas | compute-azure-apps | compute |
| Application Infrastructure | appInfra | appInfrastructure | application-infrastructure |
| Operating Systems | clientOS | clientOS | operating-systems |
| Cache | cache | cache | cache |
| Other | other-compute | other-compute | other |
| Containers | containers | containers | containers |
| Container Apps | container-apps | container-apps | container-apps |
| Container Images | container-images | container-images | container-images |
| Get Started with Containers | get-started-with-containers | get-started-with-containers | get-started-with-containers |
| Other | other | other | other |
| Databases | databases-saas | database | databases |
| NoSQL Databases | nosql-databases | nosql-databases | nosql-databases |
| Relational Databases | relational-databases | relational-databases | relational-databases |
| Ledger/Blockchain Databases | ledger-blockchain-databases | ledger-blockchain-databases | ledger-blockchain-databases |
| Data Lakes | data-lakes | data-lakes | data-lakes |
| Data Warehouse | data-warehouse | data-warehouse | data-warehouse |
| Other | other-databases | other-databases | other |
| Developer Tools | developer-tools-saas | developer-tools-azure-apps | developer-tools |
| Tools | tools-developer-tools | tools-developer-tools | tools-developer-tools |
| Scripts | scripts | scripts | scripts |
| Developer Service | devService | devService | developer-service |
| Other | other-developer-tools | other-developer-tools | other |
| DevOps | devops | devops | devops |
| Other | other | other | other |
| Identity | identity | identity | identity |
| Access management | access-management | access-management | access-management |
| Other | other | other | other |
| Integration | integration | integration | integration |
| Messaging | messaging | messaging | messaging |
| Other | other | other | other |
| Internet of Things | IoT | internet-of-things-azure-apps | internet-of-things |
| IoT Core Services | N/A | iot-core-services | iot-core-services |
| IoT Edge Modules | N/A | iot-edge-modules | iot-edge-modules |
| IoT Solutions | iot-solutions | iot-solutions | iot-solutions |
| Data Analytics & Visualization | data-analytics-and-visualization | data-analytics-and-visualization | data-analytics-and-visualization |
| IoT Connectivity | iot-connectivity | iot-connectivity | iot-connectivity |
| Other | other-internet-of-things | other-internet-of-things | other |
| IT & Management Tools | ITandAdministration | it-and-management-tools-azure-apps | it-and-management-tools |
| Management Solutions | management-solutions | management-solutions | management-solutions |
| Business Applications | businessApplication | businessApplication | business-applications |
| Other | other-it-management-tools | other-it-management-tools | other |
| Monitoring & Diagnostics | monitoring-and-diagnostics | monitoring-and-diagnostics | monitoring-and-diagnostics |
| Other | other | other | other |
| Media | media | media | media |
| Media Services | media-services | media-services | media-services |
| Content Protection | content-protection | content-protection | content-protection |
| Live & On-Demand Streaming | live-and-on-demand-streaming | live-and-on-demand-streaming | live-and-on-demand-streaming |
| Other | other | other | other |
| Migration | migration | migration | migration |
| Data Migration | data-migration | data-migration | data-migration |
| Other | other | other | other |
| Mixed Reality | mixed-reality | mixed-reality | mixed-reality |
| Other | other | other | other |
| Networking | networking | networking | networking |
| Appliance Managers | appliance-managers | appliance-managers | appliance-managers |
| Connectivity | connectivity | connectivity | connectivity |
| Firewalls | firewalls | firewalls | firewalls |
| Load Balancers | load-balancers | load-balancers | load-balancers |
| Other | other | other | other |
| Security | security | security | security |
| Identity & Access Management | identity-and-access-management | identity-and-access-management | identity-and-access-management |
| Threat Protection | threat-protection | threat-protection | threat-protection |
| Information Protection | information-protection | information-protection | information-protection |
| Other | other | other | other |
| Storage | storage-saas | storage-azure-apps | storage |
| Backup & Recovery | backup | backup | backup-and-recovery |
| Enterprise Hybrid Storage | enterprise-hybrid-storage | enterprise-hybrid-storage | enterprise-hybrid-storage |
| File Sharing | file-sharing | file-sharing | file-sharing |
| Data Lifecycle Management | data-lifecycle-management | data-lifecycle-management | data-lifecycle-management |
| Other | other-storage | other-storage | other |
| Web | web | web | web |
| Blogs & CMSs | blogs-and-cmss | blogs-and-cmss | blogs-and-cmss |
| Starter Web Apps | starter-web-apps | starter-web-apps | starter-web-apps |
| Ecommerce | ecommerce | ecommerce | ecommerce |
| Web Apps Frameworks | web-apps-frameworks | web-apps-frameworks | web-apps-frameworks |
| Web Apps | web-apps | web-apps | web-apps |
| Other | other | other | other |
Microsoft AppSource categories
These categories and their respective keys are applicable for SaaS, Power BI app, Dynamics 365 Business Central, Dynamics 365 apps on Dataverse and Power Apps, and Dynamics 365 Operations Apps offer types. Items in bold italic (like analytics) are categories and standard text items (like advanced-analytics) are subcategories below them. Use the exact key values, without changing spacing or capitalization.
| Category | SaaS keys | Dynamics 365 Business Central, Dynamics 365 apps on Dataverse and Power Apps, Dynamics 365 Operations Apps keys | Power BI app keys |
|---|---|---|---|
| Analytics | analytics | Analytics | Analytics |
| Advanced Analytics | advanced-analytics | advanced-analytics | advanced-analytics |
| Visualization & Reporting | visualization-reporting | visualization-reporting | visualization-reporting |
| Other | other | other-analytics | other-analytics |
| AI + Machine Learning | ArtificialIntelligence | ai-plus-machine-learning-dynamics | ai-plus-machine-learning-appsource |
| AI for Business | ai-for-business | ai-for-business | ai-for-business |
| Bot Apps | bot-apps | bot-apps | bot-apps |
| Other | other-ai-plus-machine-learning | other-ai-plus-machine-learning | other-ai-plus-machine-learning |
| Collaboration | Collaboration | Collaboration | collaboration |
| Contact & People | contact-people | contact-people | contact-and-people |
| Meeting Management | meeting-management | meeting-management | meeting-management |
| Site Design & Management | site-design-management | site-design-management | site-design-and-management |
| Task & Project Management | task-project-management | task-project-management | task-and-project-management |
| Voice & Video Conferencing | voice-video-conferencing | voice-video-conferencing | voice-and-video-conferencing |
| Other | other-collaboration | other-collaboration | other |
| Compliance & Legal | compliance | compliance | compliance-and-legal |
| Tax & Audit | tax-audit | tax-audit | tax-and-audit |
| Legal | Legal | Legal | legal |
| Data, Governance & Privacy | data-governance-privacy | data-governance-privacy | data-governance-and-privacy |
| Health & Safety | health-safety | health-safety | health-and-safety |
| Other | other-compliance-legal | other-compliance-legal | other |
| Customer Service | CustomerService | CustomerService | customer-service |
| Contact Center | contact-center | contact-center | contact-center |
| Face to Face Service | face-to-face-service | face-to-face-service | face-to-face-service |
| Back Office & Employee Service | back-office-employee-service | back-office-employee-service | back-office-and-employee-service |
| Knowledge & Case Management | knowledge-case-management | knowledge-case-management | knowledge-and-case-management |
| Social Media & Omnichannel Engagement | social-media-omnichannel-engagement | social-media-omnichannel-engagement | social-media-and-omnichannel-engagement |
| Other | other-customer-service | other-customer-service | other |
| Finance | Finance | Finance | finance |
| Accounting | accounting | accounting | accounting |
| Asset Management | asset-management | asset-management | asset-management |
| Analytics, Consolidation & Reporting | analytics-consolidation-reporting | analytics-consolidation-reporting | analytics-consolidation-and-reporting |
| Credit & Collections | credit-collections | credit-collections | credit-and-collections |
| Compliance & Risk Management | compliance-risk-management | compliance-risk-management | compliance-and-risk-management |
| Other | other-finance | other-finance | other |
| Human Resources | HumanResources | HumanResources | human-resources |
| Talent Acquisition | talent-acquisition | talent-acquisition | talent-acquisition |
| Talent Management | talent-management | talent-management | talent-management |
| HR Operations | hr-operations | hr-operations | hr-operations |
| Workforce Planning & Analytics | workforce-planning-analytics | workforce-planning-analytics | workforce-planning-and-analytics |
| Other | other-human-resources | other-human-resources | other |
| Internet of Things | IoT | internet-of-things-dynamics | internet-of-things-appsource |
| Asset Management & Operations | asset-management-operations | asset-management-operations | asset-management-and-operations |
| Connected Products | connected-products | connected-products | connected-products |
| Intelligent Supply Chain | intelligent-supply-chain | intelligent-supply-chain | intelligent-supply-chain |
| Predictive Maintenance | predictive-maintenance | predictive-maintenance | predictive-maintenance |
| Remote Monitoring | remote-monitoring | remote-monitoring | remote-monitoring |
| Safety & Security | safety-security | safety-security | safety-and-security |
| Smart Infrastructure & Resources | smart-infrastructure-resources | smart-infrastructure-resources | smart-infrastructure-and-resources |
| Vehicles & Mobility | vehicles-mobility | vehicles-mobility | vehicles-and-mobility |
| Other | other-internet-of-things | other-internet-of-things | other |
| IT & Management Tools | ITandAdministration | ITandAdministration | it-and-management-tools |
| Management Solutions | management-solutions | management-solutions | management-solutions |
| Business Applications | businessApplication | businessApplication | business-applications |
| Other | other-it-management-tools | other-it-management-tools | other |
| Marketing | Marketing | Marketing | marketing |
| Advertisement | advertisement | advertisement | advertisement |
| Analytics | analytics-marketing | analytics-marketing | analytics-marketing |
| Campaign Management & Automation | campaign-management-automation | campaign-management-automation | campaign-management-and-automation |
| Email Marketing | email-marketing | email-marketing | email-marketing |
| L2 -Events & Resource Management | events-resource-management | events-resource-management | events-and-resource-management |
| Research & Analysis | research-analytics | research-analytics | research-and-analysis |
| Social Media | social-media | social-media | social-media |
| Other | other-marketing | other-marketing | other |
| Operations & Supply Chain | OperationsSupplyChain | OperationsSupplyChain | operations-and-supply-chain |
| Asset & Production Management | asset-production-management | asset-production-management | asset-and-production-management |
| Demand Forecasting | demand-forecasting | demand-forecasting | demand-forecasting |
| Information Management & Connectivity | information-management-connectivity | information-management-connectivity | information-management-and-connectivity |
| Planning, Purchasing & Reporting | planning-purchasing-reporting | planning-purchasing-reporting | planning-purchasing-and-reporting |
| Quality & Service Management | quality-service-management | quality-service-management | quality-and-service-management |
| Sales & Order Management | sales-order-management | sales-order-management | sales-and-order-management |
| Transportation & Warehouse Management | transportation-warehouse-management | transportation-warehouse-management | transportation-and-warehouse-management |
| Other | other-operations-supply-chain | other-operations-supply-chain | other |
| Productivity | Productivity | Productivity | productivity |
| Content Creation & Management | content-creation-management | content-creation-management | content-creation-and-management |
| Language & Translation | language-translation | language-translation | language-and-translation |
| Document Management | document-management | document-management | document-management |
| Email Management | email-management | email-management | email-management |
| Search & Reference | search-reference | search-reference | search-and-reference |
| Other | other-productivity | other-productivity | other |
| Gamification | Gamification | Gamification | gamification |
| Sales | Sales | Sales | Sales |
| Telesales | telesales | telesales | telesales |
| Configure, Price, Quote (CPQ) | configure-price-quote | configure-price-quote | configure-price-quote |
| Contract Management | contract-management | contract-management | contract-management |
| CRM | crm | crm | crm |
| E-commerce | e-commerce | e-commerce | e-commerce |
| Business Data Enrichment | business-data-enrichment | business-data-enrichment | business-data-enrichment |
| Sales Enablement | sales-enablement | sales-enablement | sales-enablement |
| Other | other-sales | other-sales | other-sales |
| Geolocation | geolocation | geolocation | geolocation |
| Maps | maps | maps | maps |
| News & Weather | news-and-weather | news-and-weather | news-and-weather |
| Other | other-geolocation | other-geolocation | other-geolocation |
Microsoft AppSource industries
These industries and their respective keys are applicable for SaaS, Power BI app, Dynamics 365 Business Central, Dynamics 365 apps on Dataverse and Power Apps, and Dynamics 365 Operations Apps offer types. Items in bold italic (like Automotive) are categories and standard text items (like AutomotiveL2) are subcategories below them. Use the exact key values, without changing spacing or capitalization.
| Industry | SaaS, Dynamics 365 Business Central, Dynamics 365 apps on Dataverse and Power Apps, Dynamics 365 Operations Apps keys | Power BI apps keys |
|---|---|---|
| Automotive | Automotive | automotive |
| Automotive | AutomotiveL2 | AutomotiveL2 |
| Agriculture | Agriculture | agriculture |
| Other - Unsegmented | Agriculture_OtherUnsegmented | other-unsegmented |
| Distribution | Distribution | distribution |
| Wholesale | Wholesale | wholesale |
| Parcel & Package Shipping | ParcelAndPackageShipping | parcel-and-package-shipping |
| Education | Education | education |
| Higher Education | HigherEducation | higher-education |
| Primary & Secondary Education / K-12 | PrimaryAndSecondaryEducationK12 | primary-and-secondary-education |
| Libraries & Museums | LibrariesAndMuseums | libraries-and-museums |
| Financial Services | FinancialServices | financial-services |
| Banking & Capital Markets | BankingAndCapitalMarkets | banking-and-capital-markets |
| Insurance | Insurance | insurance |
| Government | Government | government |
| Defense & Intelligence | DefenseAndIntelligence | defense-and-intelligence |
| Public Safety & Justice | PublicSafetyAndJustice | public-safety-and-justice |
| Civilian Government | CivilianGovernment | civilian-government |
| Healthcare | HealthCareandLifeSciences | healthcare |
| Health Payor | HealthPayor | health-payor |
| Health Provider | HealthProvider | health-provider |
| Pharmaceuticals | Pharmaceuticals | pharmaceuticals |
| Manufacturing & Resources | Manufacturing | manufacturing-and-resources |
| Chemical & Agrochemical | ChemicalAndAgrochemical | chemical-and-agrochemical |
| Discrete Manufacturing | DiscreteManufacturing | discrete-manufacturing |
| Energy | Energy | energy |
| Retail & Consumer Goods | RetailandConsumerGoods | retail-and-consumer-goods |
| Consumer Goods | ConsumerGoods | consumer-goods |
| Retailers | Retailers | retailers |
| Media & Communications | MediaAndCommunications | media-and-communications |
| Media & Entertainment | MediaandEntertainment | media-and-entertainment |
| Telecommunications | Telecommunications | telecommunications |
| Professional Services | ProfessionalServices | professional-services |
| Legal | Legal | legal |
| Partner Professional Services | PartnerProfessionalServices | partner-professional-services |
| Architecture & Construction | ArchitectureAndConstruction | architecture-and-construction |
| Other - Unsegmented | ArchitectureAndConstruction_OtherUnsegmented | other-unsegmented |
| Hospitality & Travel | HospitalityandTravel | hospitality-and-travel |
| Hotels & Leisure | HotelsAndLeisure | hotels-and-leisure |
| Travel & Transportation | TravelAndTransportation | travel-and-transportation |
| Restaurants & Food Services | RestaurantsAndFoodServices | restaurants-and-food-services |
| Other Public Sector Industries | OtherPublicSectorIndustries | other-public-sector-industries |
| Forestry & Fishing | ForestryAndFishing | forestry-and-fishing |
| Nonprofits | Nonprofits | nonprofits |
| Real Estate | RealEstate | real-estate |
| Other - Unsegmented | RealEstate_OtherUnsegmented | other-unsegmented |
API versions and updates
| Update | What has changed? |
|---|---|
| 12-2022 | CPP public API (version 2017-10-31) is now updated to capture clientId and clientSecret for marketo connector while configuring customer leads. During lead configuration you need not provide the serverId field going forward. This update to the API does not involve any version updates or breaking changes. |