---
title: "Create a member. Roles: partner admin."
method: POST
path: "/api/partners/orgs/{orgId}/members"
tags: ["Members", "Partners"]
---

# Create a member. Roles: partner admin.

`POST /api/partners/orgs/{orgId}/members`

Create a member and optionally send an invitation email.

Notes:
- `memberNumber` is deprecated and replaced by `username`.
- `username` is dependent on your organization's configuration.
    - It must be unique across the organization.
    - Some organizations will use email address, others will have a Member ID or other identifier.
    - Contact <a href="mailto:support@newstartmobile.com">support@newstartmobile.com</a> if you are unsure of the usage for your organization.
- `externalId` should be included if you are the Identity Provider (IdP).
    - It must be unique across the organization.
    - This is typically the Member or User ID in your system.
    - Contact <a href="mailto:support@newstartmobile.com">support@newstartmobile.com</a> if you are unsure of the usage for your organization.
- `phone` (optional) assumes US unless country code is included.
- `birthDate` (optional) should use ISO-8601 `yyyy-MM-dd` format.
- `idpTypeCode` (optional) identity provider type code
    - Only used when orgs have more than one identity provider (IdP) configured.
    - Contact <a href="mailto:support@newstartmobile.com">support@newstartmobile.com</a> if you are unsure of the usage for your organization.
- If you would like an invitation email to be sent to the user:
    - Set `sendInvitation: true`
    - Provide an `invitationContext` which is included in the email:
        - "...you have been invited to `{orgName}` for `{invitationContext}`"
        - E.g. "you have been invited to Tigers Academy for Coaching 101 Training"
            - `invitationContext: "Coaching 101 Training"`
- You can set responses to profile questions (custom attributes) by specifying a `questionId` or `externalReferenceId` for each question.

## Path parameters

- `orgId` integer, required

## Request body

- PartnerMemberCreateRequest
  - `firstName` string, required
  - `middleName` string
  - `lastName` string, required
  - `phone` string
  - `birthDate` string, date
  - `email` string, required
  - `username` string
  - `memberNumber` string
  - `idpTypeCode` 'ABUSE_PREVENTION_SYSTEMS' | 'CLASSMARKER' | 'FINALSITE' | 'GAMEPLAN' | 'I9_SPORTS' | 'JDP' | 'LEAGUEAPPS' | 'LEAGUEAPPS_IDP' | 'LEAGUEAPPS_MLB' | 'MOBILE_COACH' | 'NCGA' | 'NCSI' | 'OPTOJUMP' | 'RAPSODO' | 'SAFESPORT' | 'SALESFORCE' | 'SAML_TEST_ID' | 'SPORT_80' | 'SPORTSENGINE' | 'STERLING' | 'ULTIMATE' | 'USA_FENCING' | 'USA_LACROSSE' | 'USA_LACROSSE_SAML' | 'USA_WRESTLING' | 'US_SAILING' | 'US_SKI_AND_SNOWBOARD' | 'US_SPORTS_CAMPS' | 'USSA' | 'USTA' | 'WEBPOINT' | 'WEBPOINT_OAUTH' | 'WORDPRESS'
  - `externalId` string
  - `sendInvitationEmail` boolean
  - `invitationContext` string
  - `profileResponses` PartnerMemberProfileResponseCreateRequest[]
    - `questionId` integer
    - `externalReferenceId` string
    - `responses` string[], required

## Response `200`

OK

- PartnerMemberResponse
  - `member` PartnerMemberFull, required
    - `memberNumber` string
    - `memberId` integer, required
    - `firstName` string
    - `middleName` string
    - `lastName` string
    - `email` string
    - `phone` string
    - `birthDate` string, date
    - `username` string, required
    - `externalId` string
    - `idpTypeCode` 'ABUSE_PREVENTION_SYSTEMS' | 'CLASSMARKER' | 'FINALSITE' | 'GAMEPLAN' | 'I9_SPORTS' | 'JDP' | 'LEAGUEAPPS' | 'LEAGUEAPPS_IDP' | 'LEAGUEAPPS_MLB' | 'MOBILE_COACH' | 'NCGA' | 'NCSI' | 'OPTOJUMP' | 'RAPSODO' | 'SAFESPORT' | 'SALESFORCE' | 'SAML_TEST_ID' | 'SPORT_80' | 'SPORTSENGINE' | 'STERLING' | 'ULTIMATE' | 'USA_FENCING' | 'USA_LACROSSE' | 'USA_LACROSSE_SAML' | 'USA_WRESTLING' | 'US_SAILING' | 'US_SKI_AND_SNOWBOARD' | 'US_SPORTS_CAMPS' | 'USSA' | 'USTA' | 'WEBPOINT' | 'WEBPOINT_OAUTH' | 'WORDPRESS', required
    - `createTime` string, date-time, required
    - `updateTime` string, date-time, required
    - `profileResponses` PartnerMemberProfileResponse[]
      - `questionId` integer, required
      - `externalReferenceId` string
      - `name` string, required
      - `responses` string[], required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

## Changes

- **2026-09-02** `870f28ba2607` — 5 info
  - added the optional property `error/errorId` to the response with the `400` status
  - added the optional property `error/errorId` to the response with the `401` status
  - added the optional property `error/errorId` to the response with the `403` status
  - added the optional property `error/errorId` to the response with the `404` status
  - …1 more

[Change history](https://skmtc.dev/mobilecoach/apis/untitled-api/changes/api/partners/orgs/:orgId/members/post.md)

---

[API](https://skmtc.dev/mobilecoach/apis/untitled-api.md) · [All operations](https://skmtc.dev/mobilecoach/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mobilecoach/untitled-api/revisions/870f28ba2607/schema)