> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slm.m1amdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Granting Tokens to Accounts

To grant a customer tokens outside the framework of recurring or real-time billing transactions (for example, to compensate a customer for an issue, or to reward a customer for completing a survey) the `Account` object supports calls to directly increment or decrement token balances.

Increment an Account’s Token balance:

```

 // Reference an existing account to which tokens are to be granted
 $acct = new Account();
 $acct->setMerchantAccountId('9876-5432');
  
 // Refer to an existing token type using its id
 $tok = new Token();
 $tok->setMerchantTokenId("US_FREQ_BOOK_BUYER_PT");
  
 // create a TokenAmount object and populate it with token type and
 // quantity
 $tokAmt = new TokenAmount();
 $tokAmt->setToken($tok);
 $tokAmt->setAmount(5); 
 // want to award the Account with 5 tokens of this type
  
 // Refer to another existing token type using its id
 $tok2 = new Token();
 $tok2->setMerchantTokenId("US_FREQ_DVD_BUYER_PT");
  
 // create a TokenAmount object and populate it with token type and
 // quantity
 $tokAmt2 = new TokenAmount();
 $tokAmt2->setToken($tok2);
 $tokAmt2->setAmount(2); 
 // want to award the Account with 2 tokens of this type
  
 $tokAmounts = array($tokAmt, $tokAmt2);
  
 // make the SOAP call to increment tokens
 $response = $acct->incrementTokens($tokAmounts);
  
 if($response['returnCode']==200) {
 // the call returns new token balances on the account
 // print those out
 $newTokBalances = $response['tokenAmounts'];
 foreach ($newTokBalances as $newTokBal) {
 print "Token type" 
 . $newTokenBal->token->merchantTokenId; . "\n";
 print "Token amount available" . $newTokenBal->amount; 
 . "\n";
 }
 }
```

The drawback of incrementing tokens on an `Account` object is that the action is not registered in Subscribe’s transaction framework. It is, however, tracked and available on the Subscribe Portal (choose **Search** > **Token Activity**). You may also obtain all token activities with SOAP 3.5 API calls.

**Parent topic:**[Incrementing Token Balances](../topics/Incrementing_Token_Balan)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.