POST
/
api
/
v1
/
smart-accounts
curl --request POST \
  --url https://developer-api.squads.so/api/v1/smart-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-squads-network: <x-squads-network>' \
  --data '{
  "smart_account_signers": [
    {
      "address": "<string>",
      "permissions": [
        "CAN_INITIATE"
      ]
    }
  ],
  "threshold": 123,
  "admin_address": "<string>",
  "memo": "<string>"
}'
{
  "smart_account_address": "<string>",
  "status": "created"
}

Create a new Smart Account with your desired configuration of signers, threshold, and optional settings. The Smart Account will be created on-chain and you’ll receive its address in the response.

​
Key Concepts

  • Signers and Permissions: Each signer must have specific permissions (CAN_INITIATE, CAN_VOTE, CAN_EXECUTE)
  • Threshold: The minimum number of required signatures for any action
  • Optional Settings: Configure an admin address to limit the ability to update the account’s settings to only the admin address

​
Idempotency

You can optionally provide an idempotency key via the x-idempotency-key header to prevent duplicate account creation. The idempotency key can be any random string and helps ensure that retrying the same request won’t create multiple accounts.

When using idempotency:

  • If an account was already created with the provided key → Returns status “created” and the existing account address
  • If a request is still being processed → Returns status “pending” and an empty address
  • If no idempotency key is provided → Creates a new account and returns status “created” with the new address

​
Important Notes

  • At least one signer must have CAN_INITIATE permission
  • The threshold cannot exceed the number of signers with CAN_VOTE permission
  • Use idempotency keys when retrying failed requests to prevent duplicate accounts
  • The response status field indicates whether the account is ready to use
  • Updating an account with an admin_address set requires admin mode

Authorizations

​
Authorization
string
header
required

UUID-based API key provided by Squads

Headers

​
x-squads-network
enum<string>
required

Specifies the network for the API request

Available options:
mainnet,
devnet
​
x-idempotency-key
string

Optional idempotency key to prevent duplicate account creation. If provided, the API will return the same result for identical requests.

Body

application/json
​
smart_account_signers
object[]
required

List of signers for the smart account

​
threshold
integer
required

Number of signatures required

​
admin_address
string

Optional admin address

​
memo
string

Optional memo

Response

200
application/json
Smart account creation request processed successfully
​
status
enum<string>
required

Status of the account creation. 'created' indicates the account is ready, 'pending' means it's still being processed.

Available options:
created,
pending
​
smart_account_address
string

Address of the created smart account. Empty if status is pending.