Associate tokens to an account

Associates the provided Hedera account with the provided Hedera tokens. Hedera accounts must be associated with a token first before you can transfer tokens to that account. The Hedera account that is being associated with a token is required to sign the transaction.
If the provided account is not found, the transaction will resolve to INVALID_ACCOUNT_ID.
If the provided account has been deleted, the transaction will resolve to ACCOUNT_DELETED.
If any of the provided tokens is not found, the transaction will resolve to INVALID_TOKEN_REF.
If any of the provided tokens has been deleted, the transaction will resolve to TOKEN_WAS_DELETED.
If an association between the provided account and any of the tokens already exists, the transaction will resolve to TOKEN_ALREADY_ASSOCIATED_TO_ACCOUNT.
If the provided account's associations count exceeds the constraint of maximum token associations per account, the transaction will resolve to TOKENS_PER_ACCOUNT_LIMIT_EXCEEDED.
On success, associations between the provided account and tokens are made and the account is ready to interact with the tokens.
The maximum number of Token IDs that can be associated to an account is 1,000.
Transaction Signing Requirements:
The key of the account the token is being associated to
Transaction fee payer account key
Constructor
Description
new TokenAssociateTransaction()
Initializes a TokenAssociateTransaction object
new TokenAssociateTransaction()
Methods
V2
V1
V2
Method
Type
Description
Requirement
setAccountId(<accountId>)
AccountId
The account to be associated with the provided tokens
Required
setTokenIds(<tokenId>)
TokenId
The tokens to be associated with the provided account
Required
Java
//Associate a token to an account
TokenAssociateTransaction transaction = new TokenAssociateTransaction()
        .setAccountId(accountId)
        .setTokenIds(Collections.singletonList(tokenId));
​
//Freeze the unsigned transaction, sign with the private key of the account that is being associated to a token, submit the transaction to a Hedera network
TransactionResponse txResponse = transaction.freezeWith(client).sign(accountKey).execute(client);
​
//Request the receipt of the transaction
TransactionReceipt receipt = txResponse.getReceipt(client);
​
//Get the transaction consensus status
Status transactionStatus = receipt.status;
​
System.out.println("The transaction consensus status " +transactionStatus);
//v2.0.4
JavaScript
//Associate a token to an account and freeze the unsigned transaction for signing
const transaction = await new TokenAssociateTransaction()
     .setAccountId(accountId)
     .setTokenIds([tokenId])
     .freezeWith(client);
​
//Sign with the private key of the account that is being associated to a token 
const signTx = await transaction.sign(accountKey);
​
//Submit the transaction to a Hedera network    
const txResponse = await signTx.execute(client);
​
//Request the receipt of the transaction
const receipt = await txResponse.getReceipt(client);
​
//Get the transaction consensus status
const transactionStatus = receipt.status;
​
console.log("The transaction consensus status " +transactionStatus.toString());
​
//v2.0.7
Go
//Associate the token to an account and freeze the unsigned transaction for signing
transaction, err := hedera.NewTokenAssociateTransaction().
        SetAccountID(accountId).
        SetTokenIDs(tokenId).
        FreezeWith(client)
​
if err != nil {
    panic(err)
}
​
//Sign with the private key of the account that is being associated to a token, submit the transaction to a Hedera network
txResponse, err = transaction.Sign(accountKey).Execute(client)
​
if err != nil {
    panic(err)
}
​
//Get the transaction consensus status
receipt, err = txResponse.GetReceipt(client)
​
if err != nil {
    panic(err)
}
​
//Get the transaction consensus status
status := receipt.Status
​
fmt.Printf("The transaction consensus status is %v\n", status)
​
//v2.1.0
V1
Method
Type
Description
Requirement
setAccountId(<accountId>)
AccountId
The account to be associated with the provided tokens
Required
addTokenId(<tokenId>)
TokenId
The tokens to be associated with the provided account
Required
Java
//Associate a token to an account
TokenAssociateTransaction transaction = new TokenAssociateTransaction()
        .setAccountId(accountId)
        .addTokenId(tokenId);
​
//Build the unsigned transaction, sign with the private key of the account that is being associated to a token, submit the transaction to a Hedera network
TransactionId transactionId = transaction.build(client).sign(accountKey).execute(client);
​
//Request the receipt of the transaction
TransactionReceipt getReceipt = transactionId.getReceipt(client);
​
//Obtain the transaction consensus status
Status transactionStatus = getReceipt.status;
​
System.out.println("The transaction consensus status " +transactionStatus);
//Version: 1.2.2
JavaScript
//Associate a token to an account 
const transaction = new TokenAssociateTransaction()
        .setAccountId(accountId)
        .addTokenId(tokenId); //Will change to addTokenId()
​
//Build the unsigned transaction, sign with the private key of the account that is being associated to a token, submit the transaction to a Hedera network
const transactionId = await transaction.build(client).sign(accountKey).execute(client);
​
//Request the receipt of the transaction
const getReceipt = await transactionId.getReceipt(client);
​
//Obtain the transaction consensus status
const transactionStatus = getReceipt.status;
​
console.log("The transaction consensus status " +transactionStatus);
//Version 1.4.2
Disable KYC account flag
Dissociate tokens from an account
Last updated 6 days ago
Constructor	Description
`new TokenAssociateTransaction()`	Initializes a TokenAssociateTransaction object
Method	Type	Description	Requirement
`setAccountId(<accountId>)`	AccountId	The account to be associated with the provided tokens	Required
`setTokenIds(<tokenId>)`	TokenId	The tokens to be associated with the provided account	Required