createBusinessBeneficiary

The createBusinessBeneficiary mutation creates a business beneficiary which can receive payments from an entity.

Note

routing_code in Routefusion is a high level code for the in countries local routing number. Example: In the UK their local routing_code would be a "Sort Code". You can see a map of this here Coverage

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
business_nameStringtrue
business_address1Stringfalse
business_address2Stringfalse
business_cityStringfalse
business_state_province_regionStringfalse
business_postal_codeStringfalse
business_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

GraphQL Query

mutation createBusinessBeneficiary (
    $user_id: UUID!
    $entity_id: UUID!
    $email: Email!
    $phone: String
    $business_address1: String
    $business_address2: String
    $business_city: String
    $business_state_province_region: String
    $business_postal_code: PostalCode
    $tax_number: TaxNumber
    $name_on_bank_account: String
    $swift_bic: SwiftBic
    $account_number: BankAccountNumber
    $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!,
    $business_name: String!,
    $business_country: ISO3166_1!
) {
    createBusinessBeneficiary (
        user_id: $user_id
        entity_id: $entity_id
        email: $email
        phone: $phone
        business_name: $business_name,
        business_address1: $address1
        business_address2: $address2
        business_city: $city
        business_state_province_region: $state_province_region
        business_postal_code: $postal_code
        business_country: $country
        tax_number: $tax_number
        name_on_bank_account: $name_on_bank_account
        swift_bic: $swift_bic
        account_number: $account_number
        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!