> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mightynetworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add a user as a member to the space

The user is added immediately. Depending on the space, the new member may receive a
welcome email, and there is no option to turn it off.




## OpenAPI

````yaml https://api.mn.co/admin/v1/spec/rest.json post /admin/v1/networks/{network_id}/spaces/{space_id}/members
openapi: 3.1.0
info:
  version: 1.0.0
  title: The Mighty Networks Admin API
  description: An API for managing your Mighty Networks network
servers:
  - url: https://api.mn.co
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Members
    description: Manage members of your network
  - name: Courseworks
    description: Manage course content (lessons, quizzes, sections)
  - name: Reactions
    description: Manage reactions on comments
  - name: Mute
    description: Mute posts for users
  - name: Comments
    description: Manage comments on posts
  - name: Invites
    description: Invites allow you to invite users to your network
  - name: Tags
    description: Manage tags for your network
  - name: Spaces
    description: >-
      Spaces are the organizational units within a Network where content and
      members are organized
  - name: Plans
    description: Manage plans in your network
  - name: PasswordResets
    description: Manage member password resets
  - name: Badges
    description: Manage badges for your network
  - name: Rsvps
    description: Manage event RSVPs for your network
  - name: Options
    description: Manage dropdown profile field options
  - name: Answers
    description: Manage member responses to profile fields
  - name: Subscriptions
    description: >-
      Manage payment subscriptions - recurring payments from members to hosts
      for plans
  - name: Purchases
    description: Manage purchases and subscriptions for your network
  - name: Posts
    description: Posts also include Articles.
  - name: Polls
    description: >-
      Polls and Questions allow members to share opinions and engage with each
      other
  - name: Networks
    description: >-
      Networks are the top-level organizational unit under which other resources
      are nested
  - name: Me
    description: Metadata about the requesting user
  - name: Events
    description: Events are scheduled gatherings that members can RSVP to and engage with
  - name: CustomFields
    description: Manage profile fields for your network
  - name: Collections
    description: Manage collections in your network
  - name: Assets
    description: Manage assets for your network
  - name: AbuseReports
    description: Manage abuse reports for your network
paths:
  /admin/v1/networks/{network_id}/spaces/{space_id}/members:
    post:
      tags:
        - Members
      summary: >
        Add a user as a member to the space


        The user is added immediately. Depending on the space, the new member
        may receive a

        welcome email, and there is no option to turn it off.
      operationId: create_members
      parameters:
        - name: space_id
          in: path
          required: true
          description: ID of the space
          schema:
            type: integer
            format: uint64
        - name: user_id
          in: query
          required: true
          description: ID of the user to add
          schema:
            type: integer
            format: uint64
        - $ref: '#/components/parameters/networkId'
      responses:
        '200':
          description: The newly created member object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemberResponse'
        '402':
          description: The Network is out of credits, so nothing ran
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetworkCreditRefusalResponse'
        '404':
          description: User or space not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation error (e.g., user already a member)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  parameters:
    networkId:
      name: network_id
      in: path
      description: The Network's unique integer ID, or subdomain
      required: true
      schema:
        oneOf:
          - type: integer
            description: Unique numeric network ID
            format: uint64
          - type: string
            description: Network subdomain
            format: /^[a-z][a-z0-9-]+$/
  schemas:
    MemberResponse:
      description: A member of a Network
      type: object
      required:
        - created_at
        - email
        - id
        - member_type
        - permalink
        - updated_at
      properties:
        id:
          type: integer
          format: uint64
          description: The record's integer ID
          example: '1234'
        created_at:
          type: string
          format: date-time
          description: The date and time the record was created
          example: '2026-10-30T16:42:41Z'
        updated_at:
          type: string
          format: date-time
          description: The date and time the record was last modified
          example: '2026-10-30T16:42:41Z'
        email:
          type: string
          description: >-
            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:
          type: string
          description: >-
            The member's type: 'full' (belongs to the Network) or 'limited'
            (belongs only to specific spaces)
        first_name:
          type: string
          description: The member's first name
        last_name:
          type: string
          description: The member's last name
        time_zone:
          type: string
          description: The member's time zone
        location:
          type: string
          description: The member's location
        bio:
          type: string
          description: The member's bio
        referral_count:
          type: integer
          format: uint64
          description: Number of referrals made by this member
        avatar:
          type: string
          description: URL to the member's avatar image
        categories:
          type: string
          description: Array of category objects with id and title
        permalink:
          type: string
          description: Canonical URL to the member's profile page
        ambassador_level:
          type: string
          description: The member's ambassador level
        last_visited_at:
          type: string
          format: date-time
          description: When the member last visited the Network
          example: '2026-10-30T16:42:44+00:00'
    NetworkCreditRefusalResponse:
      description: The Network is out of credits, so the request did not run
      type: object
      required:
        - credits_url
        - error
        - reason
      properties:
        error:
          type: string
          description: An error message explaining the problem encountered
        reason:
          type: string
          description: >-
            Always `network_credit_exhausted`, which tells this refusal apart
            from any other 402
        credits_url:
          type: string
          format: url
          description: The Network's Credits settings page, where a Host adds credits
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: An error message explaining the problem encountered
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.