> ## 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. # 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. ## OpenAPI ````yaml https://api.mn.co/admin/v1/spec/rest.json post /admin/v1/networks/{network_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}/members: post: tags: - Members summary: >- 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. operationId: create_members parameters: - $ref: '#/components/parameters/networkId' requestBody: description: Submit results as JSON required: true content: application/json: schema: $ref: '#/components/schemas/MemberCreateRequest' responses: '201': description: The member object, created or reused 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' '422': description: >- Validation error (e.g., invalid role, invalid member_type, unknown space, 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: MemberCreateRequest: description: Request body for creating a new member in the Network type: object required: - email - first_name - last_name properties: email: type: string format: email description: >- Email address of the member. Reuses an existing account with this address in the Network. example: user@example.com first_name: type: string description: >- First name of the member. Replaces the first name on a reused account. example: John last_name: type: string description: Last name of the member. Replaces the last name on a reused account. example: Doe role: type: string description: >- Role for the member (host, moderator, contributor). Defaults to 'contributor'. example: contributor member_type: type: string description: >- 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: type: array description: >- IDs of the spaces a limited member joins. Required when member_type is 'limited'; ignored otherwise. Duplicate IDs are ignored. items: type: integer format: uint64 send_welcome_email: type: boolean description: Whether to send a welcome email to the new member. Defaults to true. example: true 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-11-09T19:03:17Z' updated_at: type: string format: date-time description: The date and time the record was last modified example: '2026-11-09T19:03:17Z' 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-11-09T19:03:19+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.