Add Items To Benefit

Adds up to 100 items to a benefit in a pool definition.

Identify the benefit with poolDefinitionId and benefitKey, and each item with its externalId and category. The method creates the corresponding items, inheriting providerAppId, namespace, and itemSetId from the benefit's configuration in the pool definition. The corresponding pool definition items are then created asynchronously, so new items may take a short time to appear in Query Pool Definition Items results after the call returns.

Add Items to Benefit uses a partial success model. An item that's already assigned to the benefit returns a per-item failure in results.itemMetadata, while the other items are added. Check bulkActionMetadata for aggregate counts and results for per-item outcomes.

To remove items from a benefit, call Remove Items from Benefit.