---
updatedAt: 2026-04-17T03:23:37.000Z
agentTools:
  projectIndex: https://api-docs.shippedsuite.com/llms.txt
---

# /v1/bigcommerce/product_offers/add

Adds Return Protection or Warranty to a given order

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Shipped Suite API",
    "description": "API provides access to Shipped Suite functions",
    "contact": {
      "name": "Steven Ou",
      "email": "steven@invisiblecommerce.com"
    },
    "version": "v1"
  },
  "servers": [
    {
      "url": "//api.shippedsuite.com/"
    }
  ],
  "security": [
    {
      "secretKey": []
    }
  ],
  "tags": [
    {
      "name": "Product Offers",
      "description": "Operations about Product Offers"
    }
  ],
  "paths": {
    "/v1/bigcommerce/product_offers/add": {
      "post": {
        "tags": [
          "Product Offers"
        ],
        "description": "Adds Return Protection or Warranty to a given order",
        "operationId": "postV1BigcommerceProductOffersAdd",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/postV1BigcommerceProductOffersAdd"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Adds Return Protection or Warranty to a given order",
            "content": {}
          }
        },
        "security": [
          {
            "publicOrSecretKey": []
          }
        ],
        "x-codegen-request-body-name": "postV1BigcommerceProductOffersAdd"
      }
    }
  },
  "components": {
    "schemas": {
      "postV1BigcommerceProductOffersAdd": {
        "required": [
          "cart_id",
          "external_variant_id",
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The type of offer to add",
            "example": "return"
          },
          "cart_id": {
            "type": "string",
            "description": "The ID of the cart in Bigcommerce",
            "example": "cdeb2f93-2364-4f3d-86ca-49f9b3b350ae"
          },
          "external_variant_id": {
            "type": "string",
            "description": "The ID of the Variant in the external platform",
            "example": "88399874034"
          },
          "price": {
            "type": "number",
            "description": "The price of the variant, if dynamic pricing is being used",
            "format": "double",
            "example": 123.94
          },
          "quantity": {
            "type": "integer",
            "description": "The quantity to add",
            "format": "int32",
            "example": 1
          },
          "currency": {
            "type": "string",
            "description": "The display currency the order value is in.",
            "example": "JPY",
            "enum": [
              "AED",
              "AFN",
              "ALL",
              "AMD",
              "ANG",
              "AOA",
              "ARS",
              "AUD",
              "AWG",
              "AZN",
              "BAM",
              "BBD",
              "BDT",
              "BGN",
              "BHD",
              "BIF",
              "BMD",
              "BND",
              "BOB",
              "BRL",
              "BSD",
              "BTN",
              "BWP",
              "BYN",
              "BYR",
              "BZD",
              "CAD",
              "CDF",
              "CHF",
              "CLF",
              "CLP",
              "CNY",
              "COP",
              "CRC",
              "CUC",
              "CUP",
              "CVE",
              "CZK",
              "DJF",
              "DKK",
              "DOP",
              "DZD",
              "EGP",
              "ERN",
              "ETB",
              "EUR",
              "FJD",
              "FKP",
              "GBP",
              "GEL",
              "GHS",
              "GIP",
              "GMD",
              "GNF",
              "GTQ",
              "GYD",
              "HKD",
              "HNL",
              "HTG",
              "HUF",
              "IDR",
              "ILS",
              "INR",
              "IQD",
              "IRR",
              "ISK",
              "JMD",
              "JOD",
              "JPY",
              "KES",
              "KGS",
              "KHR",
              "KMF",
              "KPW",
              "KRW",
              "KWD",
              "KYD",
              "KZT",
              "LAK",
              "LBP",
              "LKR",
              "LRD",
              "LSL",
              "LYD",
              "MAD",
              "MDL",
              "MGA",
              "MKD",
              "MMK",
              "MNT",
              "MOP",
              "MRU",
              "MUR",
              "MVR",
              "MWK",
              "MXN",
              "MYR",
              "MZN",
              "NAD",
              "NGN",
              "NIO",
              "NOK",
              "NPR",
              "NZD",
              "OMR",
              "PAB",
              "PEN",
              "PGK",
              "PHP",
              "PKR",
              "PLN",
              "PYG",
              "QAR",
              "RON",
              "RSD",
              "RUB",
              "RWF",
              "SAR",
              "SBD",
              "SCR",
              "SDG",
              "SEK",
              "SGD",
              "SHP",
              "SKK",
              "SLE",
              "SLL",
              "SOS",
              "SRD",
              "SSP",
              "STD",
              "STN",
              "SVC",
              "SYP",
              "SZL",
              "THB",
              "TJS",
              "TMT",
              "TND",
              "TOP",
              "TRY",
              "TTD",
              "TWD",
              "TZS",
              "UAH",
              "UGX",
              "USD",
              "UYU",
              "UZS",
              "VES",
              "VND",
              "VUV",
              "WST",
              "XAF",
              "XAG",
              "XAU",
              "XBA",
              "XBB",
              "XBC",
              "XBD",
              "XCD",
              "XDR",
              "XOF",
              "XPD",
              "XPF",
              "XPT",
              "XTS",
              "YER",
              "ZAR",
              "ZMK",
              "ZMW",
              "BCH",
              "BTC",
              "JEP",
              "GGP",
              "IMP",
              "XFU",
              "GBX",
              "CNH",
              "USDC",
              "EEK",
              "GHS",
              "HRK",
              "LTL",
              "LVL",
              "MRO",
              "MTL",
              "TMM",
              "JPY",
              "ZWD",
              "ZWL",
              "ZWN",
              "ZWR",
              "VEF"
            ]
          },
          "exchange_rate": {
            "type": "number",
            "description": "The exchange rate used between the storefront default currency and the order display currency.",
            "format": "double",
            "example": 146.23807692
          }
        },
        "description": "Adds Return Protection or Warranty to a given order"
      }
    },
    "securitySchemes": {
      "publicOrSecretKey": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      },
      "secretKey": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    }
  },
  "x-original-swagger-version": "2.0"
}
```