---
updatedAt: 2026-06-18T06:12:47.000Z
agentTools:
  projectIndex: https://developer.hellozai.com/llms.txt
---

# Set User Disbursement Account

Set the **User's Disbursement Account** using a given **User** `:id` and a **Bank Account** `:account_id`.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Assembly API",
    "description": "Assembly (formely PromisePay) is a powerful payments engine custom-built for platforms and marketplaces.",
    "version": "2.4",
    "contact": {
      "email": "support@assemblypayments.com",
      "url": "http://docs.assemblypayments.com/"
    }
  },
  "servers": [
    {
      "url": "https://test.api.promisepay.com",
      "description": "Pre-live environment"
    },
    {
      "url": "https://secure.api.promisepay.com",
      "description": "Production environment"
    },
    {
      "url": "https://au-0000.sandbox.auth.assemblypay.com",
      "description": "Pre-Live (Sandbox) Auth issuing server and API"
    },
    {
      "url": "https://au-0000.auth.assemblypay.com",
      "description": "Production Auth issuing server and API"
    },
    {
      "description": "SwaggerHub API Auto Mocking",
      "url": "https://virtserver.swaggerhub.com/AssemblyPlatforms/assembly-api/2.1"
    }
  ],
  "x-explorer-enabled": false,
  "x-samples-languages": [
    "curl",
    "ruby",
    "php",
    "javascript",
    "csharp",
    "go"
  ],
  "paths": {
    "/users/{id}/disbursement_account": {
      "patch": {
        "tags": [
          "Users"
        ],
        "summary": "Set User Disbursement Account",
        "description": "Set the **User's Disbursement Account** using a given **User** `:id` and a **Bank Account** `:account_id`.",
        "operationId": "setUserDisbursementAccount",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "User ID",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Seller_1234"
            },
            "example": "Seller_1234"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/bank_account_id_requestBody"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/single_user"
                },
                "examples": {
                  "response": {
                    "value": {
                      "users": {
                        "created_at": "2020-04-03T07:59:00.379Z",
                        "updated_at": "2020-04-03T07:59:00.379Z",
                        "id": "Seller_1234",
                        "full_name": "Samuel Seller",
                        "email": "sam@example.com",
                        "mobile": 69543131,
                        "phone": null,
                        "logo_url": null,
                        "color_1": null,
                        "color_2": null,
                        "first_name": "Samuel",
                        "last_name": "Seller",
                        "custom_descriptor": "Sam Garden Jobs",
                        "location": "AUS",
                        "verification_state": "pending",
                        "held_state": false,
                        "roles": [
                          "customer"
                        ],
                        "dob": "encrypted",
                        "government_number": "encrypted",
                        "drivers_license": null,
                        "flags": {},
                        "related": {
                          "addresses": "11111111-2222-3333-4444-55555555555,"
                        },
                        "links": {
                          "self": "/bank_accounts/901d8cd0-6af3-0138-967d-0a58a9feac04/users",
                          "items": "/users/e6bc0480-57ae-0138-c46e-0a58a9feac03/items",
                          "card_accounts": "/users/e6bc0480-57ae-0138-c46e-0a58a9feac03/card_accounts",
                          "paypal_accounts": "/users/e6bc0480-57ae-0138-c46e-0a58a9feac03/paypal_accounts",
                          "payid_accounts": "/users/e6bc0480-57ae-0138-c46e-0a58a9feac03/payid_accounts",
                          "bank_accounts": "/users/e6bc0480-57ae-0138-c46e-0a58a9feac03/bank_accounts",
                          "wallet_accounts": "/users/e6bc0480-57ae-0138-c46e-0a58a9feac03/wallet_accounts"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "single_user": {
        "type": "object",
        "properties": {
          "users": {
            "$ref": "#/components/schemas/user"
          }
        }
      },
      "user": {
        "type": "object",
        "properties": {
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "full_name": {
            "type": "string",
            "example": "Samuel Seller"
          },
          "email": {
            "type": "string",
            "format": "email",
            "example": "samuel.seller@assemblypayments.com"
          },
          "mobile": {
            "type": "string",
            "example": 61491570156
          },
          "phone": {
            "type": "string"
          },
          "logo_url": {
            "type": "string"
          },
          "color_1": {
            "type": "string"
          },
          "color_2": {
            "type": "string"
          },
          "first_name": {
            "type": "string",
            "example": "Samuel"
          },
          "last_name": {
            "type": "string",
            "example": "Seller"
          },
          "id": {
            "type": "string",
            "example": "Seller_1234"
          },
          "custom_descriptor": {
            "type": "string"
          },
          "location": {
            "type": "string",
            "example": "AUS"
          },
          "verification_status": {
            "type": "string",
            "example": "pending"
          },
          "held_state": {
            "type": "boolean",
            "example": false
          },
          "roles": {
            "type": "array",
            "items": {
              "type": "string",
              "example": "customer"
            }
          },
          "dob": {
            "type": "string",
            "example": "encrypted"
          },
          "government_number": {
            "type": "string",
            "example": "encrypted"
          },
          "drivers_license": {
            "type": "string"
          },
          "flags": {
            "type": "object"
          },
          "related": {
            "type": "object",
            "properties": {
              "addresses": {
                "type": "string",
                "example": "fe602dcf-4175-4f88-b5be-3beb04092dcd"
              }
            }
          },
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string"
              },
              "items": {
                "type": "string"
              },
              "card_accounts": {
                "type": "string"
              },
              "paypal_accounts": {
                "type": "string"
              },
              "payid_accounts": {
                "type": "string"
              },
              "bpay_accounts": {
                "type": "string"
              },
              "bank_accounts": {
                "type": "string"
              },
              "wallet_accounts": {
                "type": "string"
              }
            }
          }
        }
      },
      "bank_account_id_requestBody": {
        "type": "object",
        "required": [
          "account_id"
        ],
        "properties": {
          "account_id": {
            "description": "Account ID (Bank account)",
            "type": "string",
            "example": "901d8cd0-6af3-0138-967d-0a58a9feac04",
            "default": "901d8cd0-6af3-0138-967d-0a58a9feac04"
          }
        }
      }
    },
    "securitySchemes": {
      "oAuth2ClientCredentials": {
        "type": "oauth2",
        "description": "Please refer to Authentication section within https://developer.assemblypayments.com/reference#authentication",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://au-0000.sandbox.auth.assemblypay.com/tokens",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "oAuth2ClientCredentials": []
    }
  ],
  "x-proxy-enabled": true,
  "x-samples-enabled": true
}
```