DevPortal
  • Reference
  • REST Management API
  • Overview
  • Abandoned carts
    • Get an abandoned cart
    • Get global abandoned cart settings
    • Abandoned Carts Settings
      • Update global abandoned cart settings
      • Get channel abandoned cart settings
      • Update channel abandoned cart settings
  • Carts
    • Batch Metafields
      • Get All Cart Metafields
      • Create multiple Metafields
      • Update multiple Metafields
      • Delete multiple Metafields
    • Carts Single
      • Create a Cart
      • Get a Cart
      • Update Customer ID
      • Delete a Cart
    • Items
      • Add Cart Line Items
      • Update Cart Line Item
      • Delete Cart Line Item
    • Metafields
      • Get Cart Metafields
      • Create a Cart Metafield
      • Get a Cart Metafield
      • Update a Cart Metafield
      • Delete a Metafield
    • Redirects
      • Create Cart Redirect URL
    • Settings
      • Get Global Cart Settings
      • Update Global Cart Settings
      • Get Channel Cart Settings
      • Update Channel Cart Settings
  • Channels
    • Get All Channels
    • Create a Channel
    • Get a Channel
    • Update a Channel
    • Active Theme
      • Get a Channel Active Theme
    • Batch Metafields
      • Get All Channel Metafields
      • Create multiple Metafields
      • Update multiple Metafields
      • Delete Multiple Metafields
    • Currency Assignments
      • Get All Channels Currency Assignments
      • Create Multiple Channels Currency Assignments
      • Update Multiple Channels Currency Assignments
      • Get Channel Currency Assignments
      • Create Channel Currency Assignments
      • Update Channel Currency Assignments
      • Delete Channel Currency Assignments
    • Listings
      • Get Channel Listings
      • Create Channel Listings
      • Update Channel Listings
      • Get a Channel Listing
    • Menus
      • Get Channel Menus
      • Create Channel Menus
      • Delete Channel Menus
    • Metafields
      • Get Channel Metafields
      • Create a Channel Metafield
      • Get a Channel Metafield
      • Update a Channel Metafield
      • Delete a Channel Metafield
    • Site
      • Get a Channel Site
      • Update a Channel Site
      • Create a Channel Site
      • Delete a Channel Site
    • Site Checkout URL
      • Upsert a Siteʼs Checkout URL
      • Delete a Siteʼs Checkout URL
  • Checkouts
    • Get a Checkout
    • Update Customer Messages
    • Checkout Billing Address
      • Add Checkout Billing Address
      • Update Checkout Billing Address
    • Checkout Consignments
      • Add Consignment to Checkout
      • Update Checkout Consignment
      • Delete Checkout Consignment
    • Checkout Coupons
      • Add Coupon to Checkout
      • Delete Checkout Coupon
    • Checkout Discounts
      • Add Discount to Checkout
    • Checkout Fees
      • Add order level fees to a checkout
      • Update order level fees in a checkout
      • Delete order level fees from a checkout.
    • Checkout Orders
      • Create an Order
    • Checkout Settings
      • Get Checkout Settings
      • Update Checkout Settings
      • Get Channel-Specific Checkout Settings
      • Update Channel-Specific Checkout Settings
    • Checkout Token
      • Create Checkout Token
  • Currencies
    • Get a Currency
    • Update a Currency
    • Delete a Currency
    • Get All Currencies
    • Create a Currency
    • Delete All Currencies
  • Customers V3
    • Get All Customers
    • Create Customers
    • Update Customers
    • Delete Customers
    • Addresses
      • Get All Customer Addresses
      • Create a Customer Address
      • Update a Customer Address
      • Delete a Customer Address
    • Attribute Values
      • Get All Customer Attribute Values
      • Upsert Customer Attribute Values
      • Delete Customer Attribute Values
    • Attributes
      • Get All Customer Attributes
      • Create a Customer Attribute
      • Update a Customer Attribute
      • Delete Customer Attributes
    • Channel Settings
      • Get Customer Settings per Channel
      • Update Customer Settings per Channel
    • Consent
      • Get Customer Consent
      • Update Customer Consent
    • Form Field Values
      • Get Customer Form Field Values
      • Upsert Customer Form Field Values (Deprecated)
    • Global Settings
      • Get Customer Settings
      • Update Customer Settings
    • Metafields
      • Get Customer Metafields
      • Create Customer Metafields
      • Get a Customer Metafield
      • Update a Metafield
      • Delete a Customer Metafield
    • Metafields Batch
      • Get All Customer Metafields
      • Create Multiple Metafields
      • Update Multiple Metafields
      • Delete Multiple Metafields
    • Stored Instruments
      • Get Stored Instruments
    • Validate Credentials
      • Validate a customer credentials
  • Customers V2
    • Get All Customers
    • Create a New Customer
    • Delete Customers
    • Get a Customer
    • Update a Customer
    • Delete a Customer
    • Get a Count of Customers
    • Customer Addresses
      • Get All Customer Addresses
      • Create a Customer Address
      • Delete Customer Address
      • Get a Customer Address
      • Update a Customer Address
      • Delete a Customer Address
      • Get a Count of Customer Addresses
    • Customer Groups
      • Get All Customer Groups
      • Create a Customer Group
      • Get a Customer Group
      • Update a Customer Group
      • Delete a Customer Group
      • Get a Count of Customer Groups
    • Customer Passwords
      • Validate a Password
  • Customer segmentation
    • Segments
      • Get All Segments
      • Create Segments
      • Update Segments
      • Delete Segments
    • Segments for a Shopper Profile
      • Get All Segments for a Shopper Profile
    • Shopper Profiles
      • Get All Shopper Profiles
      • Create Shopper Profiles
      • Delete Shopper Profiles
    • Shopper Profiles for a Segment
      • Get All Shopper Profiles in a Segment
      • Add Shopper Profiles to a Segment
      • Remove Shopper Profiles from a Segment
  • Geography
    • Countries
      • Get All Countries
      • Get a Country
      • Get a Count of All Countries
    • States
      • Get All Countryʼs States
      • Get a Countryʼs State
      • Get a Count of All States
      • Get All States
      • Get a Count of Country’s States
  • Inventory
    • Adjustments
      • Absolute Adjustment
      • Relative Adjustment
    • Items
      • Get Inventory at Locations
      • Get Inventory at a Location
      • Update Inventory Settings for a Location
  • Locations
    • Create Locations
    • Get Locations
    • Update Locations
    • Delete Locations
    • Batch Metafields
      • Get All Metafields
      • Create multiple Metafields
      • Update multiple Metafields
      • Delete Multiple Metafields
    • Metafields
      • Get Metafields
      • Create a Metafield
      • Get a Metafield
      • Update a Metafield
      • Delete a Metafield
  • Orders
    • Get an Order
    • Update an Order
    • Archive an Order
    • Get a Count of Orders
    • Get All Orders
    • Create an Order
    • Delete All Orders
    • Order Consignments
      • Get Consignments
      • Get Consignment Shipping Quotes
    • Order Coupons
      • List Order Coupons
    • Order Fees
      • Get Fees
    • Order Messages
      • Get Order Messages
    • Order Products
      • List Order Products
      • Get an Order Product
    • Order Shipments
      • Get Order Shipments
      • Create Order Shipment
      • Delete Order Shipments
      • Get Count of Order Shipments
      • Get a Shipment
      • Update a Shipment
      • Delete an Order Shipment
    • Order Shipping Addresses
      • Get Order Shipping Addresses
      • Get a Shipping Address
      • Update a Shipping Address
    • Order Shipping Addresses Quotes
      • Get Order Shipping Quotes
    • Order Status
      • Get All Order Statuses
      • Get a Single Order Status by ID
    • Order Taxes
      • Get All Order Taxes
  • Order transactions
    • Get Transactions
    • Batch Metafields
      • Get All Order Metafields
      • Create multiple Metafields
      • Update multiple Metafields
      • Delete Multiple Metafields
    • Metafields
      • Get Order Metafields
      • Create Metafields
      • Get a Metafield
      • Update a Metafield
      • Delete a Metafield
    • Order Settings
      • Get Global Order Settings
      • Update Global Order Settings
      • Get Channel Order Settings
      • Update Channel Order Settings
    • Payment Actions
      • Capture order payment
      • Void
      • Create a Refund Quote
      • Create a Refund
      • Get Refunds for Order
      • Get a Refund
      • Get All Refunds
  • Pickup
    • Get Pickups
    • Create Pickups
    • Delete Pickups
    • Update Pickups
  • Pickup methods
    • Get Pickup Methods
    • Create Pickup Methods
    • Update Pickup Methods
    • Delete Pickup Methods
  • Pickup options
    • Find Available Pickup Options
  • Pricing
    • Products
      • Get Prices (Batch)
  • Price lists
    • Get All Price Lists
    • Create a Price List
    • Delete All Price Lists
    • Get a Price List
    • Update a Price List
    • Delete a Price List
    • Price Lists Assignments
      • Get Price List Assignments
      • Create Price List Assignments
      • Delete Price List Assignments
      • Upsert Price List Assignment
    • Price Lists Records
      • Create Batch of Price Lists Records
      • Get All Price List Records
      • Upsert Price List Records
      • Delete a Price List Record
      • Get Price Records by Variant
      • Get a Price Record by Currency Code
      • Set Price List Record by Currency Code
      • Delete a Price Record by Currency Code
  • Promotions
    • Coupon Codes Bulk
      • Get Coupon Codes
      • Delete Multiple Coupon Codes
    • Coupon Codes Single
      • Create A Coupon Code
      • Delete A Coupon Code
    • Promotions Bulk
      • Get All Promotions
      • Delete Multiple Promotions
    • Promotions Single
      • Create Promotion
      • Get Promotion
      • Update Promotion
      • Delete Promotion
  • Promotion settings
    • Get Global Promotion Settings
    • Update Global Promotion Settings
  • Redirects
    • Get Redirects
    • Upsert Redirects
    • Delete Redirects
    • Import Export
      • Get Redirect Import-Export Jobs
      • Create Redirects Export Job
      • Create Redirects Import Job
      • Open Redirect Export Event Stream
      • Open Redirect Import Event Stream
      • Download Redirect Export
  • Scripts
    • Create a Script
    • Get All Scripts
    • Get a Script
    • Update a Script
    • Delete a Script
  • Settings
    • Analytics
      • Get All Web Analytics Providers
      • Get a Web Analytics Provider
      • Update a Web Analytics Provider
    • Catalog
      • Get Catalog Settings
      • Update Catalog Settings
    • Email Statuses
      • Get Transactional Email Settings
      • Update Transactional Email Settings
    • Favicon Image
      • Create Favicon Image
    • Inventory
      • Get Inventory Settings
      • Update Inventory Settings
    • Inventory Notifications
      • Get Inventory Notifications Settings
      • Update Inventory Notifications Settings
    • Logo
      • Get Store Logo Settings
      • Update Store Logo Settings
    • Logo Image
      • Create Logo Image
    • Search Filters
      • Get Enabled Filters
      • Update Enabled Filters
      • Get Available Filters
      • Get Contextual Filters
      • Upsert Contextual Filters
    • Store Locale
      • Get Locale Settings
      • Update Locale Settings
    • Store Profile
      • Get Store Profile Settings
      • Update Store Profile Settings
    • Storefront Category
      • Get Storefront Category Settings
      • Update Storefront Category Settings
    • Storefront Product
      • Get Storefront Product Settings
      • Update Storefront Product Settings
    • Storefront Robotstxt
      • Get Robots.txt Settings
      • Update Robots.txt Settings
    • Storefront Search
      • Get Storefront Search Settings
      • Update Storefront Search Settings
    • Storefront Security
      • Get Storefront Security Settings
      • Update Storefront Security Settings
    • Storefront Seo
      • Get Storefront SEO Settings
      • Update Storefront SEO Settings
    • Storefront Status
      • Get Storefront Status
      • Update Storefront Status
    • Units of Measurement
      • Get Units of Measurement Settings
      • Update Units of Measurement Settings
  • Shipping V3
    • Customs Information
      • Get Customs Information
      • Delete Customs Information
      • Upsert Customs Information
    • Shipping Settings
      • Get Shipping Settings
      • Update Shipping Settings
      • Get Shipping Settings per Channel
      • Update Shipping Settings per Channel
  • Shipping V2
    • Shipping Carrier
      • Update a Carrier Connection
      • Create a Carrier Connection
      • Delete a Carrier Connection
    • Shipping Method
      • Get All Shipping Methods in a Zone
      • Create a Shipping Method
      • Get a Shipping Method
      • Update a Shipping Method
      • Delete a Shipping Method
    • Shipping Zones
      • Get All Shipping Zones
      • Create a Shipping Zone
      • Get a Shipping Zone
      • Update a Shipping Zone
      • Delete a Shipping Zone
  • Sites
    • Create a Site
    • Get Sites
    • Get a Site
    • Update a Site
    • Delete a Site
    • Site Certificate
      • Get a Site’s SSL TLS Certificate Information
      • Upsert a Site’s SSL TLS Certificate Information
      • Get Site Certificates
    • Site Routes
      • Get a Site’s Routes
      • Create a Site Route
      • Update a Site’s Routes
      • Get a Site Route
      • Update a Site Route
      • Delete a Site Route
  • Store information
    • Get Store Information
    • Get System Timestamp
    • Batch Metafields
      • Get All Store Metafields
      • Create multiple Metafields
      • Update multiple metafields
      • Delete multiple metafields
    • Metafields
      • Get a Store Metafield
      • Update a Store Metafield
      • Delete a Metafield
  • System logs
    • Get System Logs
  • Subscribers
    • Get Subscribers
    • Create a Subscriber
    • Delete Subscribers
    • Get a Subscriber
    • Update a Subscriber
    • Delete a Subscriber
  • Tax classes
    • Get All Tax Classes
    • Get a Tax Class
  • Tax customers
    • Get Tax Customers
    • Update Tax Customers
    • Delete Tax Customers
  • Tax rates and zones
    • Tax Rates
      • Get Tax Rates
      • Update Tax Rates
      • Create Tax Rates
      • Delete Tax Rates
    • Tax Zones
      • Get Tax Zones
      • Update Tax Zones
      • Create Tax Zones
      • Delete Tax Zones
  • Tax properties
    • Get Tax Properties
    • Update Tax Properties
    • Create Tax Properties
    • Delete Tax Properties
    • Product Tax Properties
      • Get Product Tax Properties
      • Update Product Tax Properties
      • Delete Product Tax Properties
  • Tax settings
    • Get Tax Settings
    • Update Tax Settings
  • Wishlists
    • Get All Wishlists
    • Create a Wishlist
    • Get a Wishlist
    • Update a Wishlist
    • Delete a Wishlist
    • Wishlists Items
      • Delete Wishlist Item
      • Add Wishlist Item

On This Page

  • Create Promotion
  • Get Promotion
  • Update Promotion
  • Delete Promotion
Question? Give us feedback → (opens in a new tab)
Docs
Management API
Promotions
Promotions Single

Promotions (Single)

Create Promotion

Loading...

Get Promotion

Loading...

Update Promotion

Loading...

Delete Promotion

Loading...
Did you find what you were looking for?
Delete Multiple PromotionsCreate Promotion

Join our community of thousands of developers

Join thousands of other #BigCommerceDevs that are building on BigCommerce. We will also keep you updated with our monthly BigCommerce Developers newsletter. You may opt out at any time.

  • Need help? Join our BigCommerceDevs Slack
  • Find endpoints quickly in the API reference
  • Stay up to date with Release notes
  • Visit BigCommerce home

Everything you need for growth, all from one modern platform.

© Copyright 2003 - 2025 BigCommerce Pty. Ltd.––
  • Contact Us
  • Careers
  • Terms of Service
  • Privacy Policy