What parameters does POST /V1/coupons accept?

This endpoint accepts 1 parameter: coupon (Magento\SalesRule\Api\Data\CouponInterface) required.

What does POST /V1/coupons return?

The endpoint returns Magento\SalesRule\Api\Data\CouponInterface.

POSTSalesRule · Magento 2.4.9 Admin · Magento_SalesRule::quote

POST /V1/coupons

Q: What does the POST /V1/coupons endpoint do in Magento 2?

POST /V1/coupons is a Magento 2 REST endpoint in the SalesRule module. Save a coupon. Requires an admin Bearer token with ACL Magento_SalesRule::quote.

Q: Does POST /V1/coupons require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_SalesRule::quote.

POST /V1/coupons is a Magento 2 REST endpoint in the SalesRule module. Save a coupon. Requires an admin Bearer token with ACL Magento_SalesRule::quote.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

Magento\SalesRule\Api\Data\CouponInterface

Service contract

Magento\SalesRule\Api\CouponRepositoryInterface::save

Authorization

Admin Bearer token with ACL:

Magento_SalesRule::quote

Body parameters

coupon Magento\SalesRule\Api\Data\CouponInterface Required

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> admin token with ACL: Magento_SalesRule::quote

Path

/V1/coupons

Body

{
  "coupon": {
    "code": "",
    "coupon_id": 0,
    "created_at": "",
    "expiration_date": "",
    "extension_attributes": {},
    "is_primary": false,
    "rule_id": 0,
    "times_used": 0,
    "type": 0,
    "usage_limit": 0,
    "usage_per_customer": 0
  }
}