---
title: "Create member"
method: POST
path: "/users/{user_guid}/members"
tags: ["members"]
---

# Create member

`POST /users/{user_guid}/members`

This endpoint allows you to create a new member. Members are created with the required parameters credentials and institution_code, and the optional parameters id and metadata. When creating a member, youll need to include the correct type of credential required by the financial institution and provided by the user. You can find out which credential type is required with the `/institutions/{institution_code}/credentials` endpoint. If successful, the MX Platform API will respond with the newly-created member object. Once you successfully create a member, MX will immediately validate the provided credentials and attempt to aggregate data for accounts and transactions.

## Path parameters

- `user_guid` string, required

## Headers

- `X-CALLBACK-PAYLOAD` string

## Request body

- MemberCreateRequestBody
  - `client_redirect_url` string
  - `enable_app2app` boolean — This indicates whether OAuth app2app behavior is enabled for institutions that support it. Defaults to `true`. When set to `false`, any `oauth_window_uri` generated will **not** direct the end user to the institution's mobile application. This setting is not persistent. This setting currently only affects Chase institutions.
  - `member` MemberCreateRequest
    - `background_aggregation_is_disabled` boolean
    - `credentials` CredentialRequest[], required
      - `guid` string
      - `value` string
    - `id` string
    - `institution_code` string, required
    - `is_oauth` boolean
    - `metadata` string
    - `skip_aggregation` boolean
    - `use_cases` string[] — The use case associated with the member. Valid values are `PFM` and/or `MONEY_MOVEMENT`. Only set this if you've met with MX and have opted in to using this field.
  - `referral_source` string
  - `ui_message_webview_url_scheme` string

## Response `200`

OK

## Other responses

- `202` — Accepted

---

[API](https://skmtc.net/mx/apis/mx-platform-api.md) · [All operations](https://skmtc.net/mx/apis/mx-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mx/mx-platform-api/versions/b6632646ee89/schema)