>>

Create User

POST/users

Create a new user.

>>

Request Body
FieldTypeDescription
usernameStringThe user’s name. This field has to be between 2 and 32 characters and contain at least one letter.

This is different to their display_name as it denotes how they’re more formally referenced by the API.
emailStringThe user’s email.
passwordStringThe user’s password. This field has to be at least 8 characters long.
>>

Response

200User

FieldTypeDescription
idNumberThe user’s ID.
usernameStringThe user’s username. This field has to be between 2 and 32 characters long.
display_name?StringThe user’s display name. This field has to be between 2 and 32 characters long.
social_creditNumberThe user’s social credit score.
statusStatusThe user’s status.
bio?StringThe user’s bio. The upper limit is the instance’s Instance Info bio_limit.
avatar?NumberThe user’s avatar. This field has to be a valid file ID in the “avatar” bucket.
banner?NumberThe user’s banner. This field has to be a valid file ID in the “banner” bucket.
badgesNumberThe user’s badges as a bitfield.
permissionsNumberThe user’s instance-wide permissions as a bitfield.
email?StringThe user’s email. This is only shown when the user queries their own data.
verified?BooleanThe user’s verification status. This is only shown when the user queries their own data.
>>

Example

 
curl \
  --json '{
  "username": "yendri",
  "email": "yendri@llamoyendri.io",
  "password": "authentícame por favor"
}' \
  https://api.eludris.gay/users

{
  "id": 48615849987333,
  "username": "yendri",
  "social_credit": 0,
  "badges": 0,
  "permissions": 0
}