Update coupon

put

https://{tenant}.onechurchsoftware.com/api/forms/{form}/coupons/{id}

Full update of an existing coupon. First retrieve the current coupon from /api/forms/{form}/coupons/{id}, apply your changes, then send back the full object.

Required permission: Full Write Forms

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

form

int32

required

≥ 1

The id of the form.

int32

required

≥ 1

The id of the coupon.

Body Params

The new version of the coupon

name

string | null

required

The coupon's display name.

type

object | null

required

The discount type: 1 = percentage, 2 = flat amount. Only the id is used on writes.

amount

double | null

required

The discount amount or percentage. Must be greater than 0.

criteria

object | null

required

The eligibility criteria: 1 = all items, 2 = any item from a given list, 3 = all items from a given list. Only the id is used on writes.

description

string | null

The coupon's description.

code

string | null

The code customers enter to apply the coupon. Null when the coupon applies automatically.

auto

boolean | null

True when the coupon applies automatically rather than via a code.

active

boolean | null

True when the coupon is currently active.

start

date-time | null

The date the coupon becomes valid (UTC), when restricted.

end

date-time | null

The date the coupon expires (UTC), when restricted.

items

array of objects | null

The specific items the coupon applies to, when the criteria uses a list. Only the id of each item is used on writes; the items must belong to the form.

items

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Authentication is required, or the Ocs-Api-Key header is missing or invalid.

200OK

404Not Found