Skip to main content
POST
Create a new member in the Network

Authorizations

Authorization
string
header
required

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

Path Parameters

network_id
required

The Network's unique integer ID, or subdomain Unique numeric network ID

Body

application/json

Submit results as JSON

Request body for creating a new member in the Network

email
string<email>
required

Email address of the new member

Example:

"user@example.com"

first_name
string
required

First name of the new member

Example:

"John"

last_name
string
required

Last name of the new member

Example:

"Doe"

role
string

Role for the member (host, moderator, contributor). Defaults to 'contributor'.

Example:

"contributor"

member_type
string

Type of member to create. 'full' (default) joins the whole Network; 'limited' is added only to the spaces listed in space_ids.

Example:

"full"

space_ids
integer<uint64>[]

IDs of the spaces a limited member joins. Required when member_type is 'limited'; ignored otherwise. Duplicate IDs are ignored.

send_welcome_email
boolean

Whether to send a welcome email to the new member. Defaults to true.

Example:

true

Response

The newly created member object

A member of a Network

id
integer<uint64>
required

The record's integer ID

Example:

"1234"

created_at
string<date-time>
required

The date and time the record was created

Example:

"2026-08-13T00:16:13+00:00"

updated_at
string<date-time>
required

The date and time the record was last modified

Example:

"2026-08-13T00:16:13+00:00"

email
string<email>
required

The member's email address

Example:

"ada.lovelace@example.com"

member_type
string
required

The member's type: 'full' (belongs to the Network) or 'limited' (belongs only to specific spaces)

Canonical URL to the member's profile page

first_name
string

The member's first name

last_name
string

The member's last name

time_zone
string

The member's time zone

location
string

The member's location

bio
string

The member's bio

referral_count
integer<uint64>

Number of referrals made by this member

avatar
string

URL to the member's avatar image

categories
string

Array of category objects with id and title

ambassador_level
string

The member's ambassador level