Skip to main content
PUT
Update a Motivation Code
Change its name, code, mediaType, price and cost, sortOrder, or the groups it belongs to. Returns the updated motivation code.

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Path Parameters

id
integer<int64>
required

The ID of the motivation code.

Body

The motivation code details to save.

name
string
required

The name of the motivation code.

Required string length: 1 - 100
code
string
required

The code itself, as it appears on gifts.

Required string length: 1 - 100
mediaType
enum<integer> | null

The kind of media the code is used for, such as Email or Direct Mail.

Available options:
0,
1,
2,
3,
4,
5,
6,
7
siteUrl
string | null

The URL of the site or ad the code is used on.

Maximum string length: 100
description
string | null

The description of the motivation code.

Maximum string length: 1000
zipCodes
string | null

The postal codes the code was used in, separated by commas.

Maximum string length: 100
price
number<double> | null

The revenue attributed to the code, used for reporting on its return.

cost
number<double> | null

What running the code cost, used for reporting on its return.

sortOrder
integer<int32> | null

The position of the code in the order it is displayed in.

pin
boolean

Whether the code is pinned to the top of the list.

groups
object[] | null

The groups the code belongs to.

Response

OK

id
integer<int64> | null

The unique identifier of the motivation code.

name
string | null

The name of the motivation code.

code
string | null

The code itself, as it appears on gifts.

mediaType
enum<integer> | null

The kind of media the code is used for, such as Email or Direct Mail.

Available options:
0,
1,
2,
3,
4,
5,
6,
7
siteUrl
string | null

The URL of the site or ad the code is used on.

description
string | null

The description of the motivation code.

zipCodes
string | null

The postal codes the code was used in, separated by commas.

price
number<double> | null

The revenue attributed to the code, used for reporting on its return.

cost
number<double> | null

What running the code cost, used for reporting on its return.

sortOrder
integer<int32> | null

The position of the code in the order it is displayed in.

pin
boolean

Whether the code is pinned to the top of the list.

groups
object[] | null

The groups the code belongs to.

Last modified on July 28, 2026