Create / Update User - Virtuous API Docs

curl --request POST \ --url https://api.vomo.org/v1/users \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com", "birthday": "1975-12-01", "gender": "M", "password": "password1234", "org": "vomo", "invite_code": "vomoinvitationcode", "phone": "555-867-5309", "role": "VOLUNTEER" } '

{ "code": "200", "message": "User updated.", "data": { "type": "user", "id": "8205", "first_name": "Tyler", "last_name": "Reyes", "full_name": "Tyler Reyes", "email": "tyler.reyes@example.org", "address": "321 Pine Rd, McKinney, TX 75069, USA", "phone": "(555) 012-0105", "birthday": "1995-06-30", "gender": "M", "created_at": "2025-11-04T08:00:00+00:00", "updated_at": "2025-11-19T10:15:00+00:00", "user_status": "VERIFIED", "membership_status": "ACCEPTED", "membership_role": "VOLUNTEER", "participations": [], "profile_field_values": [] } }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

User to create / update

Request body for creating or updating a user.

first_name

string

required

The first name of the user

Example:

"John"

last_name

string

required

The last name of the user

Example:

"Doe"

string

required

The email for the user

Example:

"john.doe@example.com"

birthday

string<YYYY-MM-DD>

required

The birthday for the user

Example:

"1975-12-01"

gender

enum<string>

required

The gender for the user

Available options:

M,

F,

N

Example:

"M"

password

string

The user's password. Must be at least 10 characters and include letters and numbers.

Example:

"password1234"

org

string

Optional. The slug of the organization to assign the user to. Defaults to your partner organization. Must be your own organization or one of its child organizations.

Example:

"vomo"

invite_code

string

Optional. The invitation code for the target organization. When supplied, this takes precedence over the org field and determines which organization the user is added to.

Example:

"vomoinvitationcode"

phone

string

Optional. The phone number for the user.

Example:

"555-867-5309"

role

enum<string>

Optional. The user's role within your organization. Defaults to VOLUNTEER when not provided. Possible values: VOLUNTEER — standard volunteer member; ORGANIZER — can create and manage projects and events; ADMIN — organization administrator with full management access.

Available options:

VOLUNTEER,

ORGANIZER,

ADMIN

Example:

"VOLUNTEER"

Response

A user with the provided email already existed and has been updated. Returns the updated user record.

code

string

Example:

"200"

message

string

Example:

"User updated."

data

object

VOMO User

Show child attributes