Skip to main content
POST
/
users
Create a new user (legacy)
curl --request POST \
  --url http://localhost:4000/v1/users \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "username": "fallback_user_123abc",
  "address": "0x123abc456def789012345678901234567890abcd",
  "email": "john@example.com"
}
'
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "username": "john_doe",
  "id_x": 12345678,
  "created_at": "2024-05-12T13:47:00.000Z",
  "updated_at": "2024-05-13T10:00:00.000Z",
  "address": "0x123abc456def789012345678901234567890abcd",
  "privy_id": "privy-did:123abc456def789012345678901234567890abcd",
  "privy_address": "0x456def789012345678901234567890abcdef123",
  "thirdweb_address": "0x789abc012345678901234567890abcdef123456"
}

Authorizations

Authorization
string
header
required

Use this format: ApiKey <your_api_key>

Body

application/json
username
string
required

Unique username for the user.

Maximum string length: 50
Example:

"fallback_user_123abc"

address
string
required

Ethereum wallet address

Maximum string length: 42
Example:

"0x123abc456def789012345678901234567890abcd"

email
string

Email address of the user (optional).

Example:

"john@example.com"

Response

User created successfully

id
string
required

Unique identifier for the user (UUID).

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

username
string
required

Unique username of the user.

Example:

"john_doe"

id_x
object
required

Unique X / Ttwitter ID of the user.

Example:

12345678

created_at
string<date-time>
required

Timestamp of user creation.

Example:

"2024-05-12T13:47:00.000Z"

updated_at
object
required

Timestamp of last update (if any).

Example:

"2024-05-13T10:00:00.000Z"

address
string
required

Ethereum wallet address of the user.

Example:

"0x123abc456def789012345678901234567890abcd"

privy_id
object
required

Privy unique identifier.

Example:

"privy-did:123abc456def789012345678901234567890abcd"

privy_address
object
required

Privy wallet address.

Example:

"0x456def789012345678901234567890abcdef123"

thirdweb_address
object
required

Original ThirdWeb wallet address (backup).

Example:

"0x789abc012345678901234567890abcdef123456"