Handlebars Helper Function: claimRow

Returns the first unclaimed row from a marketing object and updates that row to indicate that it’s claimed. Use this helper to distribute values such as coupon codes.

This helper is available in the Winter ’27 release of Marketing Cloud Next.

1{{claimRow object=MARKETING_OBJECT_NAME
2  claimCol=COLUMN CLAIMANT_DATA="CLAIMANT_DATA_VALUE" ...}}

You can update multiple columns in the marketing object by appending more CLAIMANT_DATA="CLAIMANT_DATA_VALUE" pairs to the function.

The function returns the claimed row, or throws an exception if there aren’t any unclaimed rows.

This example claims a coupon code from the CouponCodes marketing object for a subscriber and marks that code unavailable to other subscribers. It returns the value from the CouponCode column in the marketing object. Before the helper runs, the marketing object contains these rows.

1{{#set emailAddress}}sunhi.kim@example.com{{/set}}
2
3{{#with (claimRow object="CouponCodes" claimCol="IsClaimed" EmailAddress=emailAddress)}}
4  Your coupon code is {{CouponCode}}
5{{/with}}

This example produces this output:

1Your coupon code is S5MY7BVU

The helper updates the CouponCodes marketing object. After this operation, the marketing object contains this data.

If there aren’t any unclaimed rows in the marketing object, the function throws an exception. For this reason, it’s helpful to combine this function with fallback. This example shows how to combine these functions.

1{{#set emailAddress}}sunhi.kim@example.com{{/set}}
2
3{{#with (claimRow object="CouponCodes" claimCol="IsClaimed" EmailAddress=emailAddress)}}
4  Your coupon code is {{fallback CouponCode "10OFF100"}}
5{{/with}}

If there are no unclaimed coupon codes remaining, the value of CouponCode is null. In this situation, the function returns the fallback code, “10OFF100”.

• fallback