v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB

User

Register new account

Note: This API must be called within 10 minutes of the fetch FID API call (i.e., /v2/farcaster/user/fid). Otherwise, Neynar will assign this FID to another available user.

post/v2/farcaster/user/

Headers

x-wallet-idstring required

Wallet ID to use for transactions

Request body

deadlinenumber required

fidnumber required

fnamestring

requested_user_custody_addressstring required

signaturestring required

Response

Success

messagestring required

successtrue required

Example response

{
  "signer": {
    "fid": 3,
    "public_key": "0x3daa8f99c5f760688a3c9f95716ed93dee5ed5d7722d776b7c4deac957755f22",
    "signer_uuid": "19d0c5fd-9b33-4a48-a0e2-bc7b0555baec"
  },
  "signers": [
    {
      "fid": 3,
      "public_key": "0x3daa8f99c5f760688a3c9f95716ed93dee5ed5d7722d776b7c4deac957755f22",
      "uuid": "19d0c5fd-9b33-4a48-a0e2-bc7b0555baec"
    }
  ],
  "user": {
    "auth_addresses": [
      {
        "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
        "app": {
          "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
          "fid": 3
        }
      }
    ],
    "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
    "fid": 3,
    "profile": {
      "bio": {
        "mentioned_profiles": [
          {
            "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
            "fid": 3
          }
        ]
      }
    },
    "verifications": [
      "0x5a927ac639636e534b678e81768ca19e2c6280b7"
    ],
    "verified_addresses": {
      "eth_addresses": [
        "0x5a927ac639636e534b678e81768ca19e2c6280b7"
      ],
      "primary": {
        "eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7"
      }
    }
  }
}