AppResellerOpportunities

Add items

Changed on Nov 6, 2026

Add one or more items to an opportunity

Required: Accept-Language header with Locale format. For example: en-US

post/assistedSales/v1/opportunities/{opportunityId}/items

Request

Base URL
https://marketplace.appdirect.com/api
Auth
none declared
TypeScript
https://skmtc.dev/appdirect/apis/companies/docs/assistedSales/v1/opportunities/:opportunityId/items/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

opportunityIdstring required

Opportunity ID

Request body

idstring

Item ID

parentItemIdstring

The parent product's Product ID. Only relevant to and required for add-on products.

pricingPlanIdstring

Pricing plan ID

productIdstring

Product ID

subscriptionCustomAttributesobject

Custom attributes related to the subscription

vendorRequiredFieldsobject

Custom attributes related to vendor required fields for the subscription

Example request

[
  {
    "pricingPlanId": "a22c03e9-9e27-4e85-8433-78f246345685",
    "units": [
      {
        "quantity": "8",
        "unit": "USER"
      }
    ],
    "subscriptionCustomAttributes": {
      "intended_os": [
        "other",
        "ios",
        "macos"
      ],
      "sales_agent_id": [
        "R353113R"
      ]
    },
    "vendorRequiredFields": {
      "name": [
        "jonh"
      ],
      "lastname": [
        "doe"
      ],
      "email": [
        "john.doe@acme.com"
      ]
    },
    "provisioningConfiguration": {
      "date": "1546300800000",
      "strategy": "CUSTOM"
    },
    "billingConfiguration": {
      "date": "1546300800000",
      "strategy": "CUSTOM"
    }
  }
]

Response

Success

idstring

Item ID

parentItemIdstring

The parent product's Product ID. Only relevant to and required for add-on products.

pricingPlanIdstring

Pricing plan ID

productIdstring

Product ID

subscriptionCustomAttributesobject

Custom attributes related to the subscription

vendorRequiredFieldsobject

Custom attributes related to vendor required fields for the subscription

Example response

[
  {
    "id": "37f56046-2cec-4bf4-a4e2-5a733dc849a9",
    "pricingPlanId": "a22c03e9-9e27-4e85-8433-78f246345685",
    "units": [
      {
        "quantity": "8",
        "unit": "USER"
      }
    ],
    "subscriptionCustomAttributes": {
      "intended_os": [
        "other",
        "ios",
        "macos"
      ],
      "sales_agent_id": [
        "R353113R"
      ]
    },
    "vendorRequiredFields": {
      "name": [
        "john"
      ],
      "lastname": [
        "doe"
      ],
      "email": [
        "john.doe@acme.com"
      ]
    },
    "provisioningConfiguration": {
      "date": "1546300800000",
      "strategy": "CUSTOM"
    },
    "billingConfiguration": {
      "date": "1546300800000",
      "strategy": "CUSTOM"
    }
  }
]

Changes

Nov 6, 20261fc240f06971 Revision changes
- breaking
  the request property type changed from no type to object
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's property type changed from no type to object for status
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history