POST /api/v1/smart-accounts/creation-plans

Parameters

Name	Location	Details
`X-Juicebox-Account`	header / required	Enrolled account identity, including authority chain and lowercase owner address. Enrollment derives this identity before the account exists.
`X-Juicebox-Signer`	header / required	Owner wallet or authorized bot address that signed this request.
`X-Juicebox-Issued-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; at most 30 seconds ahead of server time.
`X-Juicebox-Expires-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; in the future and within 300 seconds of issuedAt.
`X-Juicebox-Nonce`	header / required	Fresh random 32-byte lowercase nonce. A consumed nonce cannot be retried.
`X-Juicebox-Signature`	header / required	EIP-712 CenterRequest signature over every signed field. Contract-owner signatures may vary in length. This is a computed request proof, not a reusable API key.
`X-Juicebox-Grant`	header / optional	Authorized bot grant ID. Required for a bot; omit for the owner, signing grantId as the empty string.
`Idempotency-Key`	header / required	Signed retry identity. Required on plan creation and transaction submission. Preserve exact method, target, Content-Type, and body bytes; use a fresh request nonce and signature.

Request body

Field	Type	Details
`manifestId`	string required
`owners`	array required	Fields `string`
`threshold`	integer required
`saltNonce`	string required	uint256 as a lossless decimal string

JSON schema

{
  "type": "object",
  "properties": {
    "manifestId": {
      "type": "string"
    },
    "owners": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Address"
      },
      "minItems": 1,
      "maxItems": 16,
      "uniqueItems": true
    },
    "threshold": {
      "type": "integer",
      "minimum": 1,
      "maximum": 16
    },
    "saltNonce": {
      "$ref": "#/components/schemas/Uint256"
    }
  },
  "required": [
    "manifestId",
    "owners",
    "threshold",
    "saltNonce"
  ],
  "additionalProperties": false
}

Response 201

Field Type Details

creation

object
required

Fields

Field Type Details

chainId integer
required

manifestId string
required

manifestRevision string
required

address string
required

owners

array
required

Fields

string

threshold integer
required

saltNonce string
required uint256 as a lossless decimal string

initializer string
required

initializerHash string
required

transaction

object
required

Fields

Field	Type	Details
`to`	string required
`value`	string required	Values: `["0"]`
`data`	string required

initialAuthority

object
required

Fields

Field	Type	Details
`validator`	string required
`enabledSessions`	integer required	Values: `[0]`
`executors`	array required
`hooks`	array required
`fallbacks`	array required
`registryEnforced`	boolean required	Values: `[false]`

evidence

object
required

Fields

Field	Type	Details
`chainId`	integer required	Values: `[1,10,8453,42161,84532,421614,11155111,11155420]`
`blockNumber`	string required	uint256 as a lossless decimal string
`blockHash`	string required
`timestamp`	string required	uint256 as a lossless decimal string
`source`	string required	Values: `["onchain"]`

deploymentConfirmed

boolean
required

Values: [false]

JSON schema

{
  "type": "object",
  "properties": {
    "creation": {
      "$ref": "#/components/schemas/SmartCreation"
    }
  },
  "required": [
    "creation"
  ],
  "additionalProperties": false
}