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>"
}
'
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    authenticator_addresses: ['<string>'],
    authenticator_pubkeys: ['<string>'],
    offchain_signer_commitment: '<string>',
    recovery_address: '<string>'
  })
};

fetch('https://api.example.com/create-account', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "request_id": "<string>",
  "status": {
    "state": "queued"
  }
}
{
  "message": "<string>"
}

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.