createPersonalBeneficiary

The createPersonalBeneficiary mutation creates a personal beneficiary which can receive payments from an entity.

Noneditable Fields

The following beneficiary fields and related resources are not editable and cannot be updated after initial creation:

  • type
  • bank_country
  • currency
  • creator
  • entity

Parameters

ParameterTypeRequired
user_idStringtrue
entity_idStringtrue
emailStringtrue
phoneStringfalse
phone_countryStringfalse
first_nameStringtrue
last_nameStringtrue
address1Stringfalse
address2Stringfalse
cityStringfalse
state_province_regionStringfalse
postal_codeStringfalse
countryStringtrue
tax_numberStringfalse
name_on_bank_accountStringfalse
swift_bicStringfalse
account_typeStringtrue
account_numberStringtrue
routing_codeStringfalse
currencyStringtrue
bank_nameStringfalse
branch_nameStringfalse
bank_address1Stringfalse
bank_address2Stringfalse
bank_cityStringfalse
bank_state_province_regionStringfalse
bank_postal_codeStringfalse
bank_countryStringtrue
tax_number_expirationDateTimefalse
date_of_birthDateTimefalse

GraphQL Query

mutation createPersonalBeneficiary (
    $user_id: UUID!
    $entity_id: UUID!
    $email: Email!
    $phone: String
    $first_name: String!
    $last_name: String!
    $address1: String
    $address2: String
    $city: String
    $state_province_region: String
    $postal_code: PostalCode
    $country: ISO3166_1!
    $tax_number: TaxNumber
    $name_on_bank_account: String
    $swift_bic: SwiftBic
    $account_number: BankAccountNumber
    $account_type: AccountType
    $routing_code: BankRoutingCode
    $currency: ISO4217!
    $bank_name: String
    $branch_name: String
    $bank_address1: String
    $bank_address2: String
    $bank_city: String
    $bank_state_province_region: String
    $bank_postal_code: PostalCode
    $bank_country: ISO3166_1!
) {
    createPersonalBeneficiary (
        user_id: $user_id
        entity_id: $entity_id
        email: $email
        phone: $phone
        first_name: $first_name
        last_name: $last_name
        address1: $address1
        address2: $address2
        city: $city
        state_province_region: $state_province_region
        postal_code: $postal_code
        country: $country
        tax_number: $tax_number
        name_on_bank_account: $name_on_bank_account
        swift_bic: $swift_bic
        account_number: $account_number
        account_type: $account_type
        routing_code: $routing_code
        currency: $currency
        bank_name: $bank_name
        branch_name: $branch_name
        bank_address1: $bank_address1
        bank_address2: $bank_address2
        bank_city: $bank_city
        bank_state_province_region: $bank_state_province_region
        bank_postal_code: $bank_postal_code
        bank_country: $bank_country
    )
}
Language
Click Try It! to start a request and see the response here!