---
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 `200`

OK

## Other responses

- `202` — Accepted

## Changes

> 42 revisions in range; 1 not diffed.

- **2025-06-03** `b904662f5441` — 4 breaking, 4 warning, 8 info
  - the `member/most_recent_job_detail_code` response's property type/format changed from `string`/`` to `integer`/`` for status `200`
  - the `member/most_recent_job_detail_code` response's property type/format changed from `string`/`` to `integer`/`` for status `202`
  - the `member/most_recent_job_detail_text` response's property type/format changed from `string`/`` to `boolean`/`` for status `200`
  - the `member/most_recent_job_detail_text` response's property type/format changed from `string`/`` to `boolean`/`` for status `202`
  - …12 more
- **2025-02-25** `4be9949eced5` — 2 warning, 2 info
  - removed the optional property `member/actionable_error` from the response with the `200` status
  - removed the optional property `member/actionable_error` from the response with the `202` status
  - added the optional property `member/error` to the response with the `200` status
  - added the optional property `member/error` to the response with the `202` status
- …earlier changes not shown

[Full 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/22b9fde3dcdb/schema)