Create an account
A transaction that creates a Hedera account. A Hedera account is required to interact with any of the Hedera network services as you need an account to pay for all associated transaction/query fees. You can visit portal.hedera.com to create a previewnet/testnet/mainnet account. To process an account create transaction, you will need an exisiting account to pay for the transaction fee. To obtain the new account ID, request the receipt of the transaction.
When creating a new account an existing account will need to pay for the transaction fee to create the new account.
Transaction Signing Requirements
The account paying for the transaction fee is required to sign the transaction (usually client operator account private key)
Transaction Properties
Field | Description |
Key | The key for the new account. |
Initial balance | The initial balance of the account, transferred from the operator account, in Hbar. |
Receiver signature required | If true, all the account keys must sign any transaction depositing into this account (in addition to all withdrawals). default: false |
Auto Renew Period | The period of time in which the account will auto-renew in seconds. The account is charged tinybars for every auto-renew period. Duration type is in seconds. For example, one hour would result in the input value of 3,600 seconds. NOTE: This is fixed to approximately 3 months (7890000 seconds). Any other value will return the following error: AUTORENEW_DURATION_NOT_IN_RANGE. default: 2,592,000 seconds (DISABLED) |
Proxy Account | ID of the account to which this account is proxy staked (DISABLED). |
Memo | Set a note or description that should be recorded with the state of the account entity (maximum length of 100 characters). Anyone can view this memo on the network. |
Constructor | Description |
| Initializes the AccountCreateTransaction object |
new AccountCreateTransaction()
Method | Type | Requirement |
| Key | Required |
| HBar | Optional |
| boolean | Optional |
| String | Optional |
| Duration | Disabled |
| AccountId | Disabled |
Java//Create the transactionAccountCreateTransaction transaction = new AccountCreateTransaction().setKey(privateKey.getPublicKey()).setInitialBalance(new Hbar(1000));​//Submit the transaction to a Hedera networkTransactionResponse txResponse = transaction.execute(client);​//Request the receipt of the transactionTransactionReceipt receipt = txResponse.getReceipt(client);​//Get the account IDAccountId newAccountId = receipt.accountId;​System.out.println("The new account ID is " +newAccountId);​//Version 2.0.0
JavaScript//Create the transactionconst transaction = new AccountCreateTransaction().setKey(privateKey.publicKey).setInitialBalance(new Hbar(1000));​//Sign the transaction with the client operator private key and submit to a Hedera networkconst txResponse = await transaction.execute(client);​//Request the receipt of the transactionconst receipt = await txResponse.getReceipt(client);​//Get the account IDconst newAccountId = receipt.accountId;​console.log("The new account ID is " +newAccountId);​//v2.0.5
Go//Create the transactiontransaction := hedera.NewAccountCreateTransaction().SetKey(privateKey.PublicKey()).SetInitialBalance(hedera.NewHbar(1000))​//Sign the transaction with the client operator private key and submit to a Hedera networktxResponse, err := AccountCreateTransaction.Execute(client)if err != nil {panic(err)}​//Request the receipt of the transactionreceipt, err := txResponse.GetReceipt(client)if err != nil {panic(err)}​//Get the account IDnewAccountId := *receipt.AccountID​fmt.Printf("The new account ID is %v\n", newAccountId)​//Version 2.0.0
Method | Type | Requirement |
| Ed25519PubicKey | Required |
| Hbar/long | Optional |
| Duration | Disabled |
| boolean | Optional |
| AccountId | Disabled |
Java//Create the transactionAccountCreateTransaction transaction = new AccountCreateTransaction().setKey(newPublicKey).setInitialBalance(new Hbar(1));​//Sign with the client operator account private key and submit to a Hedera networkTransactionId txId = transaction.execute(client);​//Request the receipt of the transactionTransactionReceipt receipt = txId.getReceipt(client);​//Get the new account IDAccountId newAccountId = receipt.getAccountId();​System.out.println("The new account ID is " +newAccountId);​//v1.3.2
JavaScript//Create the transactionconst transaction = new AccountCreateTransaction().setKey(newPublicKey).setInitialBalance(new Hbar(1));​//Sign with the client operator account private key and submit to a Hedera networkconst txId = await transaction.execute(client);​//Request the receipt of the transactionconst receipt = await txId.getReceipt(client);​//Get the new account IDconst newAccountId = receipt.getAccountId();​console.log("The new account ID is " +newAccountId);​//v1.4.4
Method | Type | Description |
| Key | Returns the public key on the account |
| Hbar | Returns the initial balance of the account |
| Duration | Returns the auto renew period on the account |
| boolean | Returns whether the receiver signature is required or not |
Java//Create an account with 1,000 hbarAccountCreateTransaction transaction = new AccountCreateTransaction()// The only _required_ property here is `key`.setKey(newKey.getPublicKey()).setInitialBalance(new Hbar(1000));​//Return the key on the accountKey accountKey = transaction.getKey();
JavaScript//Create an account with 1,000 hbarconst transaction = new AccountCreateTransaction()// The only _required_ property here is `key`.setKey(newKey.getPublicKey()).setInitialBalance(new Hbar(1000));​//Return the key on the accountconst accountKey = transaction.getKey();
Go//Create an account with 1,000 hbarAccountCreateTransaction := hedera.NewAccountCreateTransaction().SetKey(newKey.PublicKey()).SetInitialBalance(hedera.NewHbar(1000))​//Return the key on the accountaccountKey, err := AccountCreateTransaction.GetKey()