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

# 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

## Request body

- MemberCreateRequestBody
  - `client_redirect_url` string
  - `enable_app2app` boolean
  - `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
  - `referral_source` string
  - `ui_message_webview_url_scheme` string

## Response `202`

Accepted

## Changes

- **2023-11-29** `f38a65c5b76d` — 1 info
  - added the new optional request property `enable_app2app`
- **2023-11-27** `79dbfaf92357` — 1 warning
  - removed the request property `enable_app2app`

[Change history](https://skmtc.dev/mx/apis/mx-platform-api/changes/users/:user_guid/members/post.md)

---

[API](https://skmtc.dev/mx/apis/mx-platform-api.md) · [All operations](https://skmtc.dev/mx/apis/mx-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mx/mx-platform-api/revisions/3a7db8594dd4/schema)