Sign in
users

Creates a new user

post/users

Request body

user_idstring

Optional user hash ID (will be generated if not provided)

handlestring required

User handle (unique username)

walletstring required

Wallet address (required)

namestring

Display name

biostring

User bio

locationstring

User location

websitestring uri

Website URL

donationstring

Donation link

twitter_handlestring

Twitter handle (without @)

instagram_handlestring

Instagram handle (without @)

tiktok_handlestring

TikTok handle (without @)

profile_picturestring

Profile picture CID or URL

profile_picture_sizesstring

Profile picture sizes metadata

cover_photostring

Cover photo CID or URL

cover_photo_sizesstring

Cover photo sizes metadata

profile_type'label' nullable

Type of profile (e.g., 'label' for record labels)

allow_ai_attributionboolean

Whether to allow AI attribution

spl_usdc_payout_walletstring

Solana USDC payout wallet address

coin_flair_mintstring

Coin flair mint address

Example request

{
  "user_id": "p9Km2Lx",
  "handle": "newartist",
  "wallet": "0x1234...",
  "name": "New Artist",
  "playlist_library": {
    "contents": [
      {
        "contents": [
          {
            "playlist_id": 1234
          }
        ]
      }
    ]
  },
  "events": {
    "referrer": "k9Xm5Pz"
  }
}

Response

User created successfully

transaction_hashstring

The blockchain transaction hash

block_hashstring

The blockchain block hash

block_numberinteger

The blockchain block number/height

user_idstring

The ID of the created user

Changes

No recorded changes to this endpoint across all 1 revision of this API.