Skip to main content
POST
/
create-account
cURL
curl --request POST \
  --url https://api.example.com/create-account \
  --header 'Content-Type: application/json' \
  --data '
{
  "authenticator_addresses": [
    "<string>"
  ],
  "authenticator_pubkeys": [
    "<string>"
  ],
  "offchain_signer_commitment": "<string>",
  "recovery_address": "<string>"
}
'
{
  "request_id": "<string>",
  "status": {}
}

Body

application/json

The request to create a new World ID account.

Numeric string fields in this request accept decimal or 0x/0X-prefixed hex.

​
authenticator_addresses
string<hex>[]
required

The addresses of the authenticators.

​
authenticator_pubkeys
string<hex>[]
required

The compressed public keys of the authenticators.

​
offchain_signer_commitment
string<hex>
required

The offchain signer commitment.

​
recovery_address
string<hex>
required

The recovery address.

Response

TODO

Response returned by the registry gateway for state-changing requests.

​
kind
enum<string>
required

The kind of operation that was submitted.

Available options:
create_account,
update_authenticator,
insert_authenticator,
remove_authenticator,
update_recovery_agent,
cancel_recovery_agent_update,
execute_recovery_agent_update,
recover_account
​
request_id
string
required

Identifier assigned by the gateway to the submitted request.

​
status
object
required

The current state of the request.