Skip to main content
POST
Create a member in the Network. Reuses an existing account with the given email address in the Network and replaces its name with the submitted name.

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 member. Reuses an existing account with this address in the Network.

Example:

"user@example.com"

first_name
string
required

First name of the member. Replaces the first name on a reused account.

Example:

"John"

last_name
string
required

Last name of the member. Replaces the last name on a reused account.

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 member object, created or reused

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-11-09T16:42:59Z"

updated_at
string<date-time>
required

The date and time the record was last modified

Example:

"2026-11-09T16:42:59Z"

email
string
required

The member's email address. The create-member response returns the address supplied by the Host. Other responses return an empty value when the member has not consented to commercial email, and mask it as a***@***.*** unless the Network's plan includes member-email visibility.

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

last_visited_at
string<date-time>

When the member last visited the Network

Example:

"2026-11-09T16:43:02+00:00"