Pick the Transfer Loyalty Card action (under management).
Fill in the fields below, then reference the result from later steps as {{transferLoyaltyCard.response.data}}.
Request
Path parameters
loyaltyProgramIdinteger (int64)required
Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with
the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint.
loyaltyCardIdstringrequired
Identifier of the loyalty card. You can get the identifier with
the [List loyalty
cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards)
endpoint.
**Important**: The loyalty card ID requires [URL
encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it
contains special characters. For example, you must encode `NewCard2026%`
as `NewCard2026%25`.
Request body
Enter the body as JSON in the step's Body field.
newCardIdentifierstringrequired
The identifier of the loyalty card, which must match the regular expression `^[A-Za-z0-9._%+@-]+$`.
blockReasonstring
Reason for transferring and blocking the loyalty card.
json
{"newCardIdentifier":"summer-loyalty-card-0543","blockReason":"Current card lost. Customer needs a new card."}
Response
Returns 204 with a any. Read it in later steps with {{transferLoyaltyCard.response.data.<field>}}.
Need more? See the Talon.One guide for connection setup and behaviour shared by every action.
