Update an account

PATCH

/accounts/{accountID}

When can profile data be updated:

For unverified accounts, all profile data can be edited.
During the verification process, missing or incomplete profile data can be edited.
Verified accounts can only add missing profile data.

When can't profile data be updated:

Verified accounts cannot change any existing profile data.

If you need to update information in a locked state, please contact Moov support.

To access this endpoint using an access token you'll need to specify the /accounts/{accountID}/profile.write scope.

curl -X PATCH "https://api.moov.io/accounts/{accountID}" \
  -H "Authorization: Bearer {token}" \
  -H "X-Moov-Version: v2026.10.00"

mc, _ := moov.NewClient()

var accountID string

update := moov.PatchAccount{
  ForeignID: "unique-correlation-id",
  Profile: moov.PatchProfile{
    Business: &moov.PatchBusinessProfile{
      OwnersProvided: true,
    },
  },
}

mc.PatchAccount(ctx, accountID, update)

import { Moov } from "@moovio/sdk";

const moov = new Moov({
  security: {
    username: "",
    password: "",
  },
});

async function run() {
  const result = await moov.accounts.update({
    accountID: "433cb9d1-5943-4fd5-91b4-2aef5b30e2e7",
    patchAccount: {
      profile: {
        individual: {
          name: {
            firstName: "Jordan",
            middleName: "Reese",
            lastName: "Lee",
            suffix: "Jr",
          },
          phone: {
            number: "8185551212",
            countryCode: "1",
          },
          email: "jordan.lee@classbooker.dev",
          address: {
            addressLine1: "123 Main Street",
            addressLine2: "Apt 302",
            city: "Boulder",
            stateOrProvince: "CO",
            postalCode: "80301",
            country: "US",
          },
          birthDate: {
            day: 9,
            month: 11,
            year: 1989,
          },
        },
        business: {
          businessType: "llc",
          address: {
            addressLine1: "123 Main Street",
            addressLine2: "Apt 302",
            city: "Boulder",
            stateOrProvince: "CO",
            postalCode: "80301",
            country: "US",
          },
          phone: {
            number: "8185551212",
            countryCode: "1",
          },
          email: "jordan.lee@classbooker.dev",
          taxID: {
            ein: {
              number: "12-3456789",
            },
          },
          industryCodes: {
            naics: "713940",
            sic: "7991",
            mcc: "7997",
          },
          industry: "electronics-appliances",
        },
      },
      metadata: {
        "optional": "metadata",
      },
      termsOfService: {
        manual: {
          acceptedIP: "172.217.2.46",
          acceptedUserAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36",
        },
      },
      customerSupport: {
        phone: {
          number: "8185551212",
          countryCode: "1",
        },
        email: "jordan.lee@classbooker.dev",
        address: {
          addressLine1: "123 Main Street",
          addressLine2: "Apt 302",
          city: "Boulder",
          stateOrProvince: "CO",
          postalCode: "80301",
          country: "US",
        },
      },
    },
  });

  console.log(result);
}

run();

declare(strict_types=1);

require 'vendor/autoload.php';

use Moov\MoovPhp;
use Moov\MoovPhp\Models\Components;

$sdk = MoovPhp\Moov::builder()
    ->setSecurity(
        new Components\Security(
            username: '',
            password: '',
        )
    )
    ->build();

$patchAccount = new Components\PatchAccount(
    profile: new Components\PatchProfile(
        individual: new Components\PatchIndividual(
            name: new Components\IndividualNameUpdate(
                firstName: 'Jordan',
                middleName: 'Reese',
                lastName: 'Lee',
                suffix: 'Jr',
            ),
            phone: new Components\PhoneNumber(
                number: '8185551212',
                countryCode: '1',
            ),
            email: 'jordan.lee@classbooker.dev',
            address: new Components\AddressUpdate(
                addressLine1: '123 Main Street',
                addressLine2: 'Apt 302',
                city: 'Boulder',
                stateOrProvince: 'CO',
                postalCode: '80301',
                country: 'US',
            ),
            birthDate: new Components\BirthDateUpdate(
                day: 9,
                month: 11,
                year: 1989,
            ),
        ),
        business: new Components\PatchBusiness(
            businessType: Components\BusinessType::Llc,
            address: new Components\AddressUpdate(
                addressLine1: '123 Main Street',
                addressLine2: 'Apt 302',
                city: 'Boulder',
                stateOrProvince: 'CO',
                postalCode: '80301',
                country: 'US',
            ),
            phone: new Components\PhoneNumber(
                number: '8185551212',
                countryCode: '1',
            ),
            email: 'jordan.lee@classbooker.dev',
            taxID: new Components\TaxIDUpdate(
                ein: new Components\TaxIDUpdateEin(
                    number: '12-3456789',
                ),
            ),
            industryCodes: new Components\IndustryCodes(
                naics: '713940',
                sic: '7991',
                mcc: '7997',
            ),
            industry: 'electronics-appliances',
        ),
    ),
    metadata: [
        'optional' => 'metadata',
    ],
    termsOfService: new Components\TermsOfServicePayloadUpdate(
        manual: new Components\ManualTermsOfServiceUpdate(
            acceptedIP: '172.217.2.46',
            acceptedUserAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36',
        ),
    ),
    customerSupport: new Components\PatchAccountCustomerSupport(
        phone: new Components\PhoneNumber(
            number: '8185551212',
            countryCode: '1',
        ),
        email: 'jordan.lee@classbooker.dev',
        address: new Components\AddressUpdate(
            addressLine1: '123 Main Street',
            addressLine2: 'Apt 302',
            city: 'Boulder',
            stateOrProvince: 'CO',
            postalCode: '80301',
            country: 'US',
        ),
    ),
);

$response = $sdk->accounts->updateProfile(
    accountID: '433cb9d1-5943-4fd5-91b4-2aef5b30e2e7',
    patchAccount: $patchAccount

);

if ($response->account !== null) {
    // handle response
}

package hello.world;

import io.moov.sdk.Moov;
import io.moov.sdk.models.components.*;
import io.moov.sdk.models.errors.GenericError;
import io.moov.sdk.models.errors.PatchAccountError;
import io.moov.sdk.models.operations.UpdateAccountResponse;
import java.lang.Exception;
import java.util.Map;

public class Application {

    public static void main(String[] args) throws GenericError, PatchAccountError, Exception {

        Moov sdk = Moov.builder()
                .security(Security.builder()
                    .username("")
                    .password("")
                    .build())
            .build();

        UpdateAccountResponse res = sdk.accounts().update()
                .accountID("433cb9d1-5943-4fd5-91b4-2aef5b30e2e7")
                .patchAccount(PatchAccount.builder()
                    .profile(PatchProfile.builder()
                        .individual(PatchIndividual.builder()
                            .name(IndividualNameUpdate.builder()
                                .firstName("Jordan")
                                .middleName("Reese")
                                .lastName("Lee")
                                .suffix("Jr")
                                .build())
                            .phone(PhoneNumber.builder()
                                .number("8185551212")
                                .countryCode("1")
                                .build())
                            .email("jordan.lee@classbooker.dev")
                            .address(AddressUpdate.builder()
                                .addressLine1("123 Main Street")
                                .addressLine2("Apt 302")
                                .city("Boulder")
                                .stateOrProvince("CO")
                                .postalCode("80301")
                                .country("US")
                                .build())
                            .birthDate(BirthDateUpdate.builder()
                                .day(9L)
                                .month(11L)
                                .year(1989L)
                                .build())
                            .build())
                        .business(PatchBusiness.builder()
                            .businessType(BusinessType.LLC)
                            .address(AddressUpdate.builder()
                                .addressLine1("123 Main Street")
                                .addressLine2("Apt 302")
                                .city("Boulder")
                                .stateOrProvince("CO")
                                .postalCode("80301")
                                .country("US")
                                .build())
                            .phone(PhoneNumber.builder()
                                .number("8185551212")
                                .countryCode("1")
                                .build())
                            .email("jordan.lee@classbooker.dev")
                            .taxID(TaxIDUpdate.builder()
                                .ein(TaxIDUpdateEin.builder()
                                    .number("12-3456789")
                                    .build())
                                .build())
                            .industryCodes(IndustryCodes.builder()
                                .naics("713940")
                                .sic("7991")
                                .mcc("7997")
                                .build())
                            .industry("electronics-appliances")
                            .build())
                        .build())
                    .metadata(Map.ofEntries(
                        Map.entry("optional", "metadata")))
                    .termsOfService(TermsOfServicePayloadUpdate.builder()
                        .manual(ManualTermsOfServiceUpdate.builder()
                            .acceptedIP("172.217.2.46")
                            .acceptedUserAgent("Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36")
                            .build())
                        .build())
                    .customerSupport(PatchAccountCustomerSupport.builder()
                        .phone(PhoneNumber.builder()
                            .number("8185551212")
                            .countryCode("1")
                            .build())
                        .email("jordan.lee@classbooker.dev")
                        .address(AddressUpdate.builder()
                            .addressLine1("123 Main Street")
                            .addressLine2("Apt 302")
                            .city("Boulder")
                            .stateOrProvince("CO")
                            .postalCode("80301")
                            .country("US")
                            .build())
                        .build())
                    .build())
                .call();

        if (res.account().isPresent()) {
            System.out.println(res.account().get());
        }
    }
}

from moovio_sdk import Moov
from moovio_sdk.models import components


with Moov(
    security=components.Security(
        username="",
        password="",
    ),
) as moov:

    res = moov.accounts.update(account_id="433cb9d1-5943-4fd5-91b4-2aef5b30e2e7", profile=components.PatchProfile(
        individual=components.PatchIndividual(
            name=components.IndividualNameUpdate(
                first_name="Jordan",
                middle_name="Reese",
                last_name="Lee",
                suffix="Jr",
            ),
            phone=components.PhoneNumber(
                number="8185551212",
                country_code="1",
            ),
            email="jordan.lee@classbooker.dev",
            address=components.AddressUpdate(
                address_line1="123 Main Street",
                address_line2="Apt 302",
                city="Boulder",
                state_or_province="CO",
                postal_code="80301",
                country="US",
            ),
            birth_date=components.BirthDateUpdate(
                day=9,
                month=11,
                year=1989,
            ),
        ),
        business=components.PatchBusiness(
            business_type=components.BusinessType.LLC,
            address=components.AddressUpdate(
                address_line1="123 Main Street",
                address_line2="Apt 302",
                city="Boulder",
                state_or_province="CO",
                postal_code="80301",
                country="US",
            ),
            phone=components.PhoneNumber(
                number="8185551212",
                country_code="1",
            ),
            email="jordan.lee@classbooker.dev",
            tax_id=components.TaxIDUpdate(
                ein=components.TaxIDUpdateEin(
                    number="12-3456789",
                ),
            ),
            industry_codes=components.IndustryCodes(
                naics="713940",
                sic="7991",
                mcc="7997",
            ),
            industry="electronics-appliances",
        ),
    ), metadata={
        "optional": "metadata",
    }, terms_of_service={
        "manual": {
            "accepted_ip": "172.217.2.46",
            "accepted_user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36",
        },
    }, customer_support={
        "phone": {
            "number": "8185551212",
            "country_code": "1",
        },
        "email": "jordan.lee@classbooker.dev",
        "address": {
            "address_line1": "123 Main Street",
            "address_line2": "Apt 302",
            "city": "Boulder",
            "state_or_province": "CO",
            "postal_code": "80301",
            "country": "US",
        },
    })

    # Handle response
    print(res)

require 'moov_ruby'

Models = ::Moov::Models
s = ::Moov::Client.new(
  security: Models::Components::Security.new(
    username: '',
    password: ''
  )
)
res = s.accounts.update(account_id: '433cb9d1-5943-4fd5-91b4-2aef5b30e2e7', patch_account: Models::Components::PatchAccount.new(
  profile: Models::Components::PatchProfile.new(
    individual: Models::Components::PatchIndividual.new(
      name: Models::Components::IndividualNameUpdate.new(
        first_name: 'Jordan',
        middle_name: 'Reese',
        last_name: 'Lee',
        suffix: 'Jr'
      ),
      phone: Models::Components::PhoneNumber.new(
        number: '8185551212',
        country_code: '1'
      ),
      email: 'jordan.lee@classbooker.dev',
      address: Models::Components::AddressUpdate.new(
        address_line1: '123 Main Street',
        address_line2: 'Apt 302',
        city: 'Boulder',
        state_or_province: 'CO',
        postal_code: '80301',
        country: 'US'
      ),
      birth_date: Models::Components::BirthDateUpdate.new(
        day: 9,
        month: 11,
        year: 1989
      )
    ),
    business: Models::Components::PatchBusiness.new(
      business_type: Models::Components::BusinessType::LLC,
      address: Models::Components::AddressUpdate.new(
        address_line1: '123 Main Street',
        address_line2: 'Apt 302',
        city: 'Boulder',
        state_or_province: 'CO',
        postal_code: '80301',
        country: 'US'
      ),
      phone: Models::Components::PhoneNumber.new(
        number: '8185551212',
        country_code: '1'
      ),
      email: 'jordan.lee@classbooker.dev',
      tax_id: Models::Components::TaxIDUpdate.new(
        ein: Models::Components::TaxIDUpdateEin.new(
          number: '12-3456789'
        )
      ),
      industry_codes: Models::Components::IndustryCodes.new(
        naics: '713940',
        sic: '7991',
        mcc: '7997'
      ),
      industry: 'electronics-appliances'
    )
  ),
  metadata: {
    'optional' => 'metadata',
  },
  terms_of_service: Models::Components::TermsOfServicePayloadUpdate.new(
    manual: Models::Components::ManualTermsOfServiceUpdate.new(
      accepted_ip: '172.217.2.46',
      accepted_user_agent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36'
    )
  ),
  customer_support: Models::Components::PatchAccountCustomerSupport.new(
    phone: Models::Components::PhoneNumber.new(
      number: '8185551212',
      country_code: '1'
    ),
    email: 'jordan.lee@classbooker.dev',
    address: Models::Components::AddressUpdate.new(
      address_line1: '123 Main Street',
      address_line2: 'Apt 302',
      city: 'Boulder',
      state_or_province: 'CO',
      postal_code: '80301',
      country: 'US'
    )
  )
))

unless res.account.nil?
  # handle response
end

using Moov.Sdk;
using Moov.Sdk.Models.Components;
using System.Collections.Generic;

var sdk = new MoovClient(security: new Security() {
    Username = "",
    Password = "",
});

var res = await sdk.Accounts.UpdateAsync(
    accountID: "433cb9d1-5943-4fd5-91b4-2aef5b30e2e7",
    body: new PatchAccount() {
        Profile = new PatchProfile() {
            Individual = new PatchIndividual() {
                Name = new IndividualNameUpdate() {
                    FirstName = "Jordan",
                    MiddleName = "Reese",
                    LastName = "Lee",
                    Suffix = "Jr",
                },
                Phone = new PhoneNumber() {
                    Number = "8185551212",
                    CountryCode = "1",
                },
                Email = "jordan.lee@classbooker.dev",
                Address = new AddressUpdate() {
                    AddressLine1 = "123 Main Street",
                    AddressLine2 = "Apt 302",
                    City = "Boulder",
                    StateOrProvince = "CO",
                    PostalCode = "80301",
                    Country = "US",
                },
                BirthDate = new BirthDateUpdate() {
                    Day = 9,
                    Month = 11,
                    Year = 1989,
                },
            },
            Business = new PatchBusiness() {
                BusinessType = BusinessType.Llc,
                Address = new AddressUpdate() {
                    AddressLine1 = "123 Main Street",
                    AddressLine2 = "Apt 302",
                    City = "Boulder",
                    StateOrProvince = "CO",
                    PostalCode = "80301",
                    Country = "US",
                },
                Phone = new PhoneNumber() {
                    Number = "8185551212",
                    CountryCode = "1",
                },
                Email = "jordan.lee@classbooker.dev",
                TaxID = new TaxIDUpdate() {
                    Ein = new TaxIDUpdateEin() {
                        Number = "12-3456789",
                    },
                },
                IndustryCodes = new IndustryCodes() {
                    Naics = "713940",
                    Sic = "7991",
                    Mcc = "7997",
                },
                Industry = "electronics-appliances",
            },
        },
        Metadata = new Dictionary<string, string>() {
            { "optional", "metadata" },
        },
        TermsOfService = new TermsOfServicePayloadUpdate() {
            Manual = new ManualTermsOfServiceUpdate() {
                AcceptedIP = "172.217.2.46",
                AcceptedUserAgent = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36",
            },
        },
        CustomerSupport = new PatchAccountCustomerSupport() {
            Phone = new PhoneNumber() {
                Number = "8185551212",
                CountryCode = "1",
            },
            Email = "jordan.lee@classbooker.dev",
            Address = new AddressUpdate() {
                AddressLine1 = "123 Main Street",
                AddressLine2 = "Apt 302",
                City = "Boulder",
                StateOrProvince = "CO",
                PostalCode = "80301",
                Country = "US",
            },
        },
    }
);

// handle response

The request completed successfully.

application/json

{
  "mode": "sandbox",
  "accountID": "53ca67ea-6fd3-423f-9544-ce2404159d33",
  "accountType": "business",
  "displayName": "Whole Body Fitness LLC",
  "profile": {
    "business": {
      "legalBusinessName": "Whole Body Fitness LLC",
      "ownersProvided": false
    }
  },
  "verification": {
    "verificationStatus": "unverified",
    "status": "unverified"
  },
  "settings": {
    "cardPayment": {
      "statementDescriptor": "Whole Body Fitness LLC"
    },
    "achPayment": {
      "companyName": "Whole Body Fitne"
    }
  },
  "createdOn": "2024-12-16T17:55:20.557151867Z",
  "updatedOn": "2024-12-16T17:55:20.557151867Z"
}

x-request-id


      
      string

required

A unique identifier used to trace requests.

The server could not understand the request due to invalid syntax.

application/json

{
  "error": "string"
}

x-request-id


      
      string

required

A unique identifier used to trace requests.

The request contained missing or expired authentication.

x-request-id


      
      string

required

A unique identifier used to trace requests.

The user is not authorized to make the request.

x-request-id


      
      string

required

A unique identifier used to trace requests.

The requested resource was not found.

x-request-id


      
      string

required

A unique identifier used to trace requests.

The request conflicted with the current state of the target resource.

application/json

{
  "error": "string"
}

x-request-id


      
      string

required

A unique identifier used to trace requests.

The request was well-formed, but the contents failed validation. Check the request for missing or invalid fields.

application/json

{
  "profile": {
    "individual": {
      "name": {
        "firstName": "string",
        "middleName": "string",
        "lastName": "string",
        "suffix": "string"
      },
      "phone": {
        "number": "string",
        "countryCode": "string"
      },
      "email": "string",
      "address": {
        "addressLine1": "string",
        "addressLine2": "string",
        "city": "string",
        "stateOrProvince": "string",
        "postalCode": "string",
        "country": "string"
      },
      "birthDate": {
        "day": "string",
        "month": "string",
        "year": "string"
      },
      "governmentID": {
        "ssn": {
          "full": "string",
          "lastFour": "string"
        },
        "itin": {
          "full": "string",
          "lastFour": "string"
        }
      }
    },
    "business": {
      "legalBusinessName": "string",
      "doingBusinessAs": "string",
      "businessType": "string",
      "address": {
        "addressLine1": "string",
        "addressLine2": "string",
        "city": "string",
        "stateOrProvince": "string",
        "postalCode": "string",
        "country": "string"
      },
      "phone": {
        "number": "string",
        "countryCode": "string"
      },
      "email": "string",
      "website": "string",
      "description": "string",
      "taxID": {
        "ein": {
          "number": "string"
        }
      },
      "industryCodes": {
        "naics": "string",
        "sic": "string",
        "mcc": "string"
      },
      "industry": "electronics-appliances",
      "primaryRegulator": "string"
    }
  },
  "metadata": "string",
  "termsOfService": {
    "token": "string",
    "manual": {
      "acceptedDate": "string",
      "acceptedDomain": "string",
      "acceptedIP": "string",
      "acceptedUserAgent": "string"
    }
  },
  "foreignID": "string",
  "customerSupport": {
    "phone": {
      "number": "string",
      "countryCode": "string"
    },
    "email": "string",
    "address": {
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "stateOrProvince": "string",
      "postalCode": "string",
      "country": "string"
    },
    "website": "string"
  },
  "settings": {
    "cardPayment": {
      "statementDescriptor": "string"
    },
    "achPayment": {
      "companyName": "string"
    }
  },
  "error": "string"
}

x-request-id


      
      string

required

A unique identifier used to trace requests.

Request was refused due to rate limiting.

x-request-id


      
      string

required

A unique identifier used to trace requests.

The request failed due to an unexpected error.

x-request-id


      
      string

required

A unique identifier used to trace requests.

The request failed because a downstream service failed to respond.

x-request-id


      
      string

required

A unique identifier used to trace requests.

Headers

X-Moov-Version


      
      string

Set this header to v2026.10.00 to use the API described in this specification. When omitted, the server defaults to v2024.01.00, the earliest supported version, which may not match the behavior documented here. An unrecognized well-formed version uses the latest supported version that is not newer than the requested version, when one exists. For example, v2026.08.00 uses v2026.07.00. A malformed value, such as 2022, returns a 404 response.

Possible values: v2026.10.00

Path parameters

accountID


      
      string

required

Body

application/json

Describes the fields available when patching a Moov account.

customerSupport

object
          | null

User-provided information that can be displayed on credit card transactions for customers to use when contacting a customer support team. This data is only allowed on a business account.

Show child attributes

customerSupport

address

object

Show child attributes

customerSupport.address

addressLine1

string

<=60 characters

addressLine2

string

<=32 characters

city

string

<=32 characters

country

string

<=2 characters

postalCode

string

<=5 characters

stateOrProvince

string

<=2 characters

email

string<email>

<=255 characters

phone

object

Show child attributes

customerSupport.phone

countryCode

string

<=1 characters

number

string

<=10 characters

website

string<uri>

foreignID

string

metadata

object
          | null

Free-form key-value pair list. Useful for storing information that is not captured elsewhere.

profile

object

Describes the fields available when patching a profile. Each object can be patched independent of patching the other fields.

Show child attributes

profile

business

object

Show child attributes

profile.business

address

object

Show child attributes

profile.business.address

addressLine1

string

<=60 characters

addressLine2

string

<=32 characters

city

string

<=32 characters

country

string

<=2 characters

postalCode

string

<=5 characters

stateOrProvince

string

<=2 characters

businessType

string<enum>

The type of entity represented by this business.

Possible values: soleProprietorship, unincorporatedAssociation, trust, publicCorporation, privateCorporation, llc, partnership, unincorporatedNonProfit, incorporatedNonProfit, governmentEntity

description

string

[10 to 100] characters

doingBusinessAs

string

<=64 characters

email

string<email>

<=255 characters

industry

string

Classification identifier for the industry. Use the GET industries endpoint to retrieve an array of valid industry details for a merchant, inducing all industry field values.

industryCodes

object

Show child attributes

profile.business.industryCodes

mcc

string

4 characters

naics

string

[2 to 6] characters

sic

string

4 characters

legalBusinessName

string

<=64 characters

ownersProvided

boolean

phone

object

Show child attributes

profile.business.phone

countryCode

string

<=1 characters

number

string

<=10 characters

primaryRegulator

string<enum>

If the business is a financial institution, this field describes its primary regulator.

Possible values: OCC, FDIC, NCUA, FRB, state-cu-regulator

taxID

object

An EIN (employer identification number) for the business. For sole proprietors, an SSN can be used as the EIN.

Show child attributes

profile.business.taxID

ein

object

Show child attributes

profile.business.taxID.ein

number

string

website

string

<=100 characters

individual

object

Describes the fields available when patching an individual.

Show child attributes

profile.individual

address

object

Show child attributes

profile.individual.address

addressLine1

string

<=60 characters

addressLine2

string

<=32 characters

city

string

<=32 characters

country

string

<=2 characters

postalCode

string

<=5 characters

stateOrProvince

string

<=2 characters

birthDate

object

Show child attributes

profile.individual.birthDate

day

integer

month

integer

year

integer

email

string<email>

<=255 characters

governmentID

object

Show child attributes

profile.individual.governmentID

itin

object

Show child attributes

profile.individual.governmentID.itin

full

string

lastFour

string

ssn

object

Show child attributes

profile.individual.governmentID.ssn

full

string

lastFour

string

name

object

Show child attributes

profile.individual.name

firstName

string

<=64 characters

The individual's first given name.

lastName

string

<=64 characters

The individual's family name.

middleName

string

<=64 characters

The individual's second given name, if any.

suffix

string

<=20 characters

Suffix of a given name.

phone

object

Show child attributes

profile.individual.phone

countryCode

string

<=1 characters

number

string

<=10 characters

settings

object

Show child attributes

settings

achPayment

object

Show child attributes

settings.achPayment

companyName

string

cardPayment

object

Show child attributes

settings.cardPayment

statementDescriptor

string

termsOfService

object

Show child attributes

termsOfService

manual

object

Describes the acceptance of the Terms of Service. All data is required, and must be from the user.

Show child attributes

termsOfService.manual

acceptedDate

string<date-time>

The date and time the terms of service were accepted.

acceptedDomain

string<uri>

acceptedIP

string

The IP address (IPv4 or IPv6) from which the terms of service were accepted.

acceptedUserAgent

string

<=255 characters

The user-agent of the user making the request.

token

string

Response

application/json

accountID

string

required

Unique identifier for this account.

accountType

string<enum>

required

The type of entity represented by this account.

Possible values: individual, business, guest

createdOn

string<date-time>

required

displayName

string

<=64 characters required

mode

string<enum>

required

The operating mode for an account.

Possible values: sandbox, production

profile

object

required

Describes a Moov account profile. A profile will have a business, individual, or guest depending on the account's type.

Show child attributes

profile

business

object

Describes a business.

Show child attributes

profile.business

legalBusinessName

string

<=64 characters required

The legal name under which the entity is registered.

ownersProvided

boolean

required

address

object

Show child attributes

profile.business.address

addressLine1

string

<=60 characters required

city

string

<=32 characters required

country

string

<=2 characters required

postalCode

string

<=5 characters required

stateOrProvince

string

<=2 characters required

addressLine2

string

<=32 characters

businessType

string<enum>

The type of entity represented by this business.

description

string

[10 to 100] characters

doingBusinessAs

string

<=64 characters

A registered trade name under which the business operates, if different from its legal name.

email

string<email>

<=255 characters

industry

string

Classification identifier for the industry. Use the GET industries endpoint to retrieve an array of valid industry details for a merchant, inducing all industry field values.

industryCodes

object

Show child attributes

profile.business.industryCodes

mcc

string

4 characters

naics

string

[2 to 6] characters

sic

string

4 characters

phone

object

Show child attributes

profile.business.phone

countryCode

string

<=1 characters

number

string

<=10 characters

primaryRegulator

string<enum>

If the business is a financial institution, this field describes its primary regulator.

Possible values: OCC, FDIC, NCUA, FRB, state-cu-regulator

representatives

array<object>

Show child attributes

profile.business.representatives[]

address

object

Show child attributes

profile.business.representatives[].address

addressLine1

string

<=60 characters required

city

string

<=32 characters required

country

string

<=2 characters required

postalCode

string

<=5 characters required

stateOrProvince

string

<=2 characters required

addressLine2

string

<=32 characters

birthDateProvided

boolean

Indicates whether this representative's birth date has been provided.

createdOn

string<date-time>

disabledOn

string<date-time>

email

string<email>

<=255 characters

governmentIDProvided

boolean

Indicates whether a government ID (SSN, ITIN, etc.) has been provided for this representative.

name

object

Show child attributes

profile.business.representatives[].name

firstName

string

<=64 characters required

The individual's first given name.

lastName

string

<=64 characters required

The individual's family name.

middleName

string

<=64 characters

The individual's second given name, if any.

suffix

string

<=20 characters

Suffix of a given name.

phone

object

Show child attributes

profile.business.representatives[].phone

countryCode

string

<=1 characters

number

string

<=10 characters

representativeID

string

Unique identifier for this representative.

responsibilities

object

Describes the job responsibilities of a business representative.

Show child attributes

profile.business.representatives[].responsibilities

isController

boolean

Indicates whether this individual has significant management responsibilities within the business.

isOwner

boolean

If true, this field indicates that the individual has a business ownership stake of at least 25% in the business. If the representative does not own at least 25% of the business, this field should be false.

jobTitle

string

<=64 characters

ownershipPercentage

integer

The percentage of ownership this individual has in the business (required if isOwner is true).

updatedOn

string<date-time>

taxIDProvided

boolean

Indicates whether a tax ID has been provided for this business.

website

string<uri>

<=100 characters

guest

object

Describes a guest account profile.

Show child attributes

profile.guest

name

string

<=64 characters required

The name associated with the guest account. This will default to "Guest {accountIDfirst8}" if no other name is provided.

email

string<email>

<=255 characters

phone

object

Show child attributes

profile.guest.phone

countryCode

string

<=1 characters

number

string

<=10 characters

individual

object

Describes an individual.

Show child attributes

profile.individual

name

object

required

Show child attributes

profile.individual.name

firstName

string

<=64 characters required

The individual's first given name.

lastName

string

<=64 characters required

The individual's family name.

middleName

string

<=64 characters

The individual's second given name, if any.

suffix

string

<=20 characters

Suffix of a given name.

address

object

Show child attributes

profile.individual.address

addressLine1

string

<=60 characters required

city

string

<=32 characters required

country

string

<=2 characters required

postalCode

string

<=5 characters required

stateOrProvince

string

<=2 characters required

addressLine2

string

<=32 characters

birthDateProvided

boolean

Indicates whether this individual's birth date has been provided.

email

string<email>

<=255 characters

governmentIDProvided

boolean

Indicates whether a government ID (SSN, ITIN, etc.) has been provided for this individual.

phone

object

Show child attributes

profile.individual.phone

countryCode

string

<=1 characters

number

string

<=10 characters

updatedOn

string<date-time>

required

verification

object

required

Describes identity verification status and relevant identity verification documents.

Show child attributes

verification

status

string<enum>

required deprecated

Possible states an account verification can be in.

Possible values: unverified, pending, verified, errored

details

string<enum>

deprecated

Additional detail for a verification status.

Possible values: failedAutoVerify, docDobMismatch, docNameMismatch, docAddressMismatch, docNumberMismatch, docIncomplete, docFailedRisk, potentialAccountSanctionsMatch, potentialRepresentativeSanctionsMatch, failedOther

documents

array<object>

Show child attributes

verification.documents[]

contentType

string

The document's MIME type.

documentID

string

parseErrors

array<string>

Optional array of errors encountered during automated parsing.

type

string<enum>

Types of documents that can be uploaded.

Possible values: driversLicense, passport, utilityBill, bankStatement

uploadedAt

string<date-time>

verificationStatus

string<enum>

deprecated

Possible states an account verification can be in.

Possible values: unverified, pending, resubmit, review, verified, failed

capabilities

array<object>

Show child attributes

capabilities[]

capability

string

status

string

customerSupport

object

User-provided information that can be displayed on credit card transactions for customers to use when contacting a customer support team. This data is only allowed on a business account.

Show child attributes

customerSupport

address

object

Show child attributes

customerSupport.address

addressLine1

string

<=60 characters required

city

string

<=32 characters required

country

string

<=2 characters required

postalCode

string

<=5 characters required

stateOrProvince

string

<=2 characters required

addressLine2

string

<=32 characters

email

string<email>

<=255 characters

phone

object

Show child attributes

customerSupport.phone

countryCode

string

<=1 characters

number

string

<=10 characters

website

string<uri>

disconnectedOn

string<date-time>

foreignID

string

<=64 characters

Optional alias from a foreign/external system which can be used to reference this resource.

metadata

object

Free-form key-value pair list. Useful for storing information that is not captured elsewhere.

settings

object

User provided settings to manage an account.

Show child attributes

settings

achPayment

object

Show child attributes

settings.achPayment

companyName

string

[1 to 16] characters required

The description that shows up on ACH transactions. This will default to the account's display name on account creation.

cardPayment

object

User provided settings to manage card payments. This data is only allowed on a business account.

Show child attributes

settings.cardPayment

statementDescriptor

string

[4 to 22] characters

The description that shows up on credit card transactions. This will default to the accounts display name on account creation.

termsOfService

object

Describes the acceptance of the Terms of Service.

Show child attributes

termsOfService

acceptedDate

string<date-time>

required

The date and time the terms of service were accepted.

acceptedIP

string

required

The IP address (IPv4 or IPv6) from which the terms of service were accepted.

curl -X PATCH "https://api.moov.io/accounts/{accountID}" \
  -H "Authorization: Bearer {token}" \
  -H "X-Moov-Version: v2026.10.00"

mc, _ := moov.NewClient()

var accountID string

update := moov.PatchAccount{
  ForeignID: "unique-correlation-id",
  Profile: moov.PatchProfile{
    Business: &moov.PatchBusinessProfile{
      OwnersProvided: true,
    },
  },
}

mc.PatchAccount(ctx, accountID, update)

import { Moov } from "@moovio/sdk";

const moov = new Moov({
  security: {
    username: "",
    password: "",
  },
});

async function run() {
  const result = await moov.accounts.update({
    accountID: "433cb9d1-5943-4fd5-91b4-2aef5b30e2e7",
    patchAccount: {
      profile: {
        individual: {
          name: {
            firstName: "Jordan",
            middleName: "Reese",
            lastName: "Lee",
            suffix: "Jr",
          },
          phone: {
            number: "8185551212",
            countryCode: "1",
          },
          email: "jordan.lee@classbooker.dev",
          address: {
            addressLine1: "123 Main Street",
            addressLine2: "Apt 302",
            city: "Boulder",
            stateOrProvince: "CO",
            postalCode: "80301",
            country: "US",
          },
          birthDate: {
            day: 9,
            month: 11,
            year: 1989,
          },
        },
        business: {
          businessType: "llc",
          address: {
            addressLine1: "123 Main Street",
            addressLine2: "Apt 302",
            city: "Boulder",
            stateOrProvince: "CO",
            postalCode: "80301",
            country: "US",
          },
          phone: {
            number: "8185551212",
            countryCode: "1",
          },
          email: "jordan.lee@classbooker.dev",
          taxID: {
            ein: {
              number: "12-3456789",
            },
          },
          industryCodes: {
            naics: "713940",
            sic: "7991",
            mcc: "7997",
          },
          industry: "electronics-appliances",
        },
      },
      metadata: {
        "optional": "metadata",
      },
      termsOfService: {
        manual: {
          acceptedIP: "172.217.2.46",
          acceptedUserAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36",
        },
      },
      customerSupport: {
        phone: {
          number: "8185551212",
          countryCode: "1",
        },
        email: "jordan.lee@classbooker.dev",
        address: {
          addressLine1: "123 Main Street",
          addressLine2: "Apt 302",
          city: "Boulder",
          stateOrProvince: "CO",
          postalCode: "80301",
          country: "US",
        },
      },
    },
  });

  console.log(result);
}

run();

declare(strict_types=1);

require 'vendor/autoload.php';

use Moov\MoovPhp;
use Moov\MoovPhp\Models\Components;

$sdk = MoovPhp\Moov::builder()
    ->setSecurity(
        new Components\Security(
            username: '',
            password: '',
        )
    )
    ->build();

$patchAccount = new Components\PatchAccount(
    profile: new Components\PatchProfile(
        individual: new Components\PatchIndividual(
            name: new Components\IndividualNameUpdate(
                firstName: 'Jordan',
                middleName: 'Reese',
                lastName: 'Lee',
                suffix: 'Jr',
            ),
            phone: new Components\PhoneNumber(
                number: '8185551212',
                countryCode: '1',
            ),
            email: 'jordan.lee@classbooker.dev',
            address: new Components\AddressUpdate(
                addressLine1: '123 Main Street',
                addressLine2: 'Apt 302',
                city: 'Boulder',
                stateOrProvince: 'CO',
                postalCode: '80301',
                country: 'US',
            ),
            birthDate: new Components\BirthDateUpdate(
                day: 9,
                month: 11,
                year: 1989,
            ),
        ),
        business: new Components\PatchBusiness(
            businessType: Components\BusinessType::Llc,
            address: new Components\AddressUpdate(
                addressLine1: '123 Main Street',
                addressLine2: 'Apt 302',
                city: 'Boulder',
                stateOrProvince: 'CO',
                postalCode: '80301',
                country: 'US',
            ),
            phone: new Components\PhoneNumber(
                number: '8185551212',
                countryCode: '1',
            ),
            email: 'jordan.lee@classbooker.dev',
            taxID: new Components\TaxIDUpdate(
                ein: new Components\TaxIDUpdateEin(
                    number: '12-3456789',
                ),
            ),
            industryCodes: new Components\IndustryCodes(
                naics: '713940',
                sic: '7991',
                mcc: '7997',
            ),
            industry: 'electronics-appliances',
        ),
    ),
    metadata: [
        'optional' => 'metadata',
    ],
    termsOfService: new Components\TermsOfServicePayloadUpdate(
        manual: new Components\ManualTermsOfServiceUpdate(
            acceptedIP: '172.217.2.46',
            acceptedUserAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36',
        ),
    ),
    customerSupport: new Components\PatchAccountCustomerSupport(
        phone: new Components\PhoneNumber(
            number: '8185551212',
            countryCode: '1',
        ),
        email: 'jordan.lee@classbooker.dev',
        address: new Components\AddressUpdate(
            addressLine1: '123 Main Street',
            addressLine2: 'Apt 302',
            city: 'Boulder',
            stateOrProvince: 'CO',
            postalCode: '80301',
            country: 'US',
        ),
    ),
);

$response = $sdk->accounts->updateProfile(
    accountID: '433cb9d1-5943-4fd5-91b4-2aef5b30e2e7',
    patchAccount: $patchAccount

);

if ($response->account !== null) {
    // handle response
}

package hello.world;

import io.moov.sdk.Moov;
import io.moov.sdk.models.components.*;
import io.moov.sdk.models.errors.GenericError;
import io.moov.sdk.models.errors.PatchAccountError;
import io.moov.sdk.models.operations.UpdateAccountResponse;
import java.lang.Exception;
import java.util.Map;

public class Application {

    public static void main(String[] args) throws GenericError, PatchAccountError, Exception {

        Moov sdk = Moov.builder()
                .security(Security.builder()
                    .username("")
                    .password("")
                    .build())
            .build();

        UpdateAccountResponse res = sdk.accounts().update()
                .accountID("433cb9d1-5943-4fd5-91b4-2aef5b30e2e7")
                .patchAccount(PatchAccount.builder()
                    .profile(PatchProfile.builder()
                        .individual(PatchIndividual.builder()
                            .name(IndividualNameUpdate.builder()
                                .firstName("Jordan")
                                .middleName("Reese")
                                .lastName("Lee")
                                .suffix("Jr")
                                .build())
                            .phone(PhoneNumber.builder()
                                .number("8185551212")
                                .countryCode("1")
                                .build())
                            .email("jordan.lee@classbooker.dev")
                            .address(AddressUpdate.builder()
                                .addressLine1("123 Main Street")
                                .addressLine2("Apt 302")
                                .city("Boulder")
                                .stateOrProvince("CO")
                                .postalCode("80301")
                                .country("US")
                                .build())
                            .birthDate(BirthDateUpdate.builder()
                                .day(9L)
                                .month(11L)
                                .year(1989L)
                                .build())
                            .build())
                        .business(PatchBusiness.builder()
                            .businessType(BusinessType.LLC)
                            .address(AddressUpdate.builder()
                                .addressLine1("123 Main Street")
                                .addressLine2("Apt 302")
                                .city("Boulder")
                                .stateOrProvince("CO")
                                .postalCode("80301")
                                .country("US")
                                .build())
                            .phone(PhoneNumber.builder()
                                .number("8185551212")
                                .countryCode("1")
                                .build())
                            .email("jordan.lee@classbooker.dev")
                            .taxID(TaxIDUpdate.builder()
                                .ein(TaxIDUpdateEin.builder()
                                    .number("12-3456789")
                                    .build())
                                .build())
                            .industryCodes(IndustryCodes.builder()
                                .naics("713940")
                                .sic("7991")
                                .mcc("7997")
                                .build())
                            .industry("electronics-appliances")
                            .build())
                        .build())
                    .metadata(Map.ofEntries(
                        Map.entry("optional", "metadata")))
                    .termsOfService(TermsOfServicePayloadUpdate.builder()
                        .manual(ManualTermsOfServiceUpdate.builder()
                            .acceptedIP("172.217.2.46")
                            .acceptedUserAgent("Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36")
                            .build())
                        .build())
                    .customerSupport(PatchAccountCustomerSupport.builder()
                        .phone(PhoneNumber.builder()
                            .number("8185551212")
                            .countryCode("1")
                            .build())
                        .email("jordan.lee@classbooker.dev")
                        .address(AddressUpdate.builder()
                            .addressLine1("123 Main Street")
                            .addressLine2("Apt 302")
                            .city("Boulder")
                            .stateOrProvince("CO")
                            .postalCode("80301")
                            .country("US")
                            .build())
                        .build())
                    .build())
                .call();

        if (res.account().isPresent()) {
            System.out.println(res.account().get());
        }
    }
}

from moovio_sdk import Moov
from moovio_sdk.models import components


with Moov(
    security=components.Security(
        username="",
        password="",
    ),
) as moov:

    res = moov.accounts.update(account_id="433cb9d1-5943-4fd5-91b4-2aef5b30e2e7", profile=components.PatchProfile(
        individual=components.PatchIndividual(
            name=components.IndividualNameUpdate(
                first_name="Jordan",
                middle_name="Reese",
                last_name="Lee",
                suffix="Jr",
            ),
            phone=components.PhoneNumber(
                number="8185551212",
                country_code="1",
            ),
            email="jordan.lee@classbooker.dev",
            address=components.AddressUpdate(
                address_line1="123 Main Street",
                address_line2="Apt 302",
                city="Boulder",
                state_or_province="CO",
                postal_code="80301",
                country="US",
            ),
            birth_date=components.BirthDateUpdate(
                day=9,
                month=11,
                year=1989,
            ),
        ),
        business=components.PatchBusiness(
            business_type=components.BusinessType.LLC,
            address=components.AddressUpdate(
                address_line1="123 Main Street",
                address_line2="Apt 302",
                city="Boulder",
                state_or_province="CO",
                postal_code="80301",
                country="US",
            ),
            phone=components.PhoneNumber(
                number="8185551212",
                country_code="1",
            ),
            email="jordan.lee@classbooker.dev",
            tax_id=components.TaxIDUpdate(
                ein=components.TaxIDUpdateEin(
                    number="12-3456789",
                ),
            ),
            industry_codes=components.IndustryCodes(
                naics="713940",
                sic="7991",
                mcc="7997",
            ),
            industry="electronics-appliances",
        ),
    ), metadata={
        "optional": "metadata",
    }, terms_of_service={
        "manual": {
            "accepted_ip": "172.217.2.46",
            "accepted_user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36",
        },
    }, customer_support={
        "phone": {
            "number": "8185551212",
            "country_code": "1",
        },
        "email": "jordan.lee@classbooker.dev",
        "address": {
            "address_line1": "123 Main Street",
            "address_line2": "Apt 302",
            "city": "Boulder",
            "state_or_province": "CO",
            "postal_code": "80301",
            "country": "US",
        },
    })

    # Handle response
    print(res)

require 'moov_ruby'

Models = ::Moov::Models
s = ::Moov::Client.new(
  security: Models::Components::Security.new(
    username: '',
    password: ''
  )
)
res = s.accounts.update(account_id: '433cb9d1-5943-4fd5-91b4-2aef5b30e2e7', patch_account: Models::Components::PatchAccount.new(
  profile: Models::Components::PatchProfile.new(
    individual: Models::Components::PatchIndividual.new(
      name: Models::Components::IndividualNameUpdate.new(
        first_name: 'Jordan',
        middle_name: 'Reese',
        last_name: 'Lee',
        suffix: 'Jr'
      ),
      phone: Models::Components::PhoneNumber.new(
        number: '8185551212',
        country_code: '1'
      ),
      email: 'jordan.lee@classbooker.dev',
      address: Models::Components::AddressUpdate.new(
        address_line1: '123 Main Street',
        address_line2: 'Apt 302',
        city: 'Boulder',
        state_or_province: 'CO',
        postal_code: '80301',
        country: 'US'
      ),
      birth_date: Models::Components::BirthDateUpdate.new(
        day: 9,
        month: 11,
        year: 1989
      )
    ),
    business: Models::Components::PatchBusiness.new(
      business_type: Models::Components::BusinessType::LLC,
      address: Models::Components::AddressUpdate.new(
        address_line1: '123 Main Street',
        address_line2: 'Apt 302',
        city: 'Boulder',
        state_or_province: 'CO',
        postal_code: '80301',
        country: 'US'
      ),
      phone: Models::Components::PhoneNumber.new(
        number: '8185551212',
        country_code: '1'
      ),
      email: 'jordan.lee@classbooker.dev',
      tax_id: Models::Components::TaxIDUpdate.new(
        ein: Models::Components::TaxIDUpdateEin.new(
          number: '12-3456789'
        )
      ),
      industry_codes: Models::Components::IndustryCodes.new(
        naics: '713940',
        sic: '7991',
        mcc: '7997'
      ),
      industry: 'electronics-appliances'
    )
  ),
  metadata: {
    'optional' => 'metadata',
  },
  terms_of_service: Models::Components::TermsOfServicePayloadUpdate.new(
    manual: Models::Components::ManualTermsOfServiceUpdate.new(
      accepted_ip: '172.217.2.46',
      accepted_user_agent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36'
    )
  ),
  customer_support: Models::Components::PatchAccountCustomerSupport.new(
    phone: Models::Components::PhoneNumber.new(
      number: '8185551212',
      country_code: '1'
    ),
    email: 'jordan.lee@classbooker.dev',
    address: Models::Components::AddressUpdate.new(
      address_line1: '123 Main Street',
      address_line2: 'Apt 302',
      city: 'Boulder',
      state_or_province: 'CO',
      postal_code: '80301',
      country: 'US'
    )
  )
))

unless res.account.nil?
  # handle response
end

using Moov.Sdk;
using Moov.Sdk.Models.Components;
using System.Collections.Generic;

var sdk = new MoovClient(security: new Security() {
    Username = "",
    Password = "",
});

var res = await sdk.Accounts.UpdateAsync(
    accountID: "433cb9d1-5943-4fd5-91b4-2aef5b30e2e7",
    body: new PatchAccount() {
        Profile = new PatchProfile() {
            Individual = new PatchIndividual() {
                Name = new IndividualNameUpdate() {
                    FirstName = "Jordan",
                    MiddleName = "Reese",
                    LastName = "Lee",
                    Suffix = "Jr",
                },
                Phone = new PhoneNumber() {
                    Number = "8185551212",
                    CountryCode = "1",
                },
                Email = "jordan.lee@classbooker.dev",
                Address = new AddressUpdate() {
                    AddressLine1 = "123 Main Street",
                    AddressLine2 = "Apt 302",
                    City = "Boulder",
                    StateOrProvince = "CO",
                    PostalCode = "80301",
                    Country = "US",
                },
                BirthDate = new BirthDateUpdate() {
                    Day = 9,
                    Month = 11,
                    Year = 1989,
                },
            },
            Business = new PatchBusiness() {
                BusinessType = BusinessType.Llc,
                Address = new AddressUpdate() {
                    AddressLine1 = "123 Main Street",
                    AddressLine2 = "Apt 302",
                    City = "Boulder",
                    StateOrProvince = "CO",
                    PostalCode = "80301",
                    Country = "US",
                },
                Phone = new PhoneNumber() {
                    Number = "8185551212",
                    CountryCode = "1",
                },
                Email = "jordan.lee@classbooker.dev",
                TaxID = new TaxIDUpdate() {
                    Ein = new TaxIDUpdateEin() {
                        Number = "12-3456789",
                    },
                },
                IndustryCodes = new IndustryCodes() {
                    Naics = "713940",
                    Sic = "7991",
                    Mcc = "7997",
                },
                Industry = "electronics-appliances",
            },
        },
        Metadata = new Dictionary<string, string>() {
            { "optional", "metadata" },
        },
        TermsOfService = new TermsOfServicePayloadUpdate() {
            Manual = new ManualTermsOfServiceUpdate() {
                AcceptedIP = "172.217.2.46",
                AcceptedUserAgent = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36",
            },
        },
        CustomerSupport = new PatchAccountCustomerSupport() {
            Phone = new PhoneNumber() {
                Number = "8185551212",
                CountryCode = "1",
            },
            Email = "jordan.lee@classbooker.dev",
            Address = new AddressUpdate() {
                AddressLine1 = "123 Main Street",
                AddressLine2 = "Apt 302",
                City = "Boulder",
                StateOrProvince = "CO",
                PostalCode = "80301",
                Country = "US",
            },
        },
    }
);

// handle response

The request completed successfully.

application/json

{
  "mode": "sandbox",
  "accountID": "53ca67ea-6fd3-423f-9544-ce2404159d33",
  "accountType": "business",
  "displayName": "Whole Body Fitness LLC",
  "profile": {
    "business": {
      "legalBusinessName": "Whole Body Fitness LLC",
      "ownersProvided": false
    }
  },
  "verification": {
    "verificationStatus": "unverified",
    "status": "unverified"
  },
  "settings": {
    "cardPayment": {
      "statementDescriptor": "Whole Body Fitness LLC"
    },
    "achPayment": {
      "companyName": "Whole Body Fitne"
    }
  },
  "createdOn": "2024-12-16T17:55:20.557151867Z",
  "updatedOn": "2024-12-16T17:55:20.557151867Z"
}

x-request-id


      
      string

required

A unique identifier used to trace requests.

The server could not understand the request due to invalid syntax.

application/json

{
  "error": "string"
}

x-request-id


      
      string

required

A unique identifier used to trace requests.

The request contained missing or expired authentication.

x-request-id


      
      string

required

A unique identifier used to trace requests.

The user is not authorized to make the request.

x-request-id


      
      string

required

A unique identifier used to trace requests.

The requested resource was not found.

x-request-id


      
      string

required

A unique identifier used to trace requests.

The request conflicted with the current state of the target resource.

application/json

{
  "error": "string"
}

x-request-id


      
      string

required

A unique identifier used to trace requests.

The request was well-formed, but the contents failed validation. Check the request for missing or invalid fields.

application/json

{
  "profile": {
    "individual": {
      "name": {
        "firstName": "string",
        "middleName": "string",
        "lastName": "string",
        "suffix": "string"
      },
      "phone": {
        "number": "string",
        "countryCode": "string"
      },
      "email": "string",
      "address": {
        "addressLine1": "string",
        "addressLine2": "string",
        "city": "string",
        "stateOrProvince": "string",
        "postalCode": "string",
        "country": "string"
      },
      "birthDate": {
        "day": "string",
        "month": "string",
        "year": "string"
      },
      "governmentID": {
        "ssn": {
          "full": "string",
          "lastFour": "string"
        },
        "itin": {
          "full": "string",
          "lastFour": "string"
        }
      }
    },
    "business": {
      "legalBusinessName": "string",
      "doingBusinessAs": "string",
      "businessType": "string",
      "address": {
        "addressLine1": "string",
        "addressLine2": "string",
        "city": "string",
        "stateOrProvince": "string",
        "postalCode": "string",
        "country": "string"
      },
      "phone": {
        "number": "string",
        "countryCode": "string"
      },
      "email": "string",
      "website": "string",
      "description": "string",
      "taxID": {
        "ein": {
          "number": "string"
        }
      },
      "industryCodes": {
        "naics": "string",
        "sic": "string",
        "mcc": "string"
      },
      "industry": "electronics-appliances",
      "primaryRegulator": "string"
    }
  },
  "metadata": "string",
  "termsOfService": {
    "token": "string",
    "manual": {
      "acceptedDate": "string",
      "acceptedDomain": "string",
      "acceptedIP": "string",
      "acceptedUserAgent": "string"
    }
  },
  "foreignID": "string",
  "customerSupport": {
    "phone": {
      "number": "string",
      "countryCode": "string"
    },
    "email": "string",
    "address": {
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "stateOrProvince": "string",
      "postalCode": "string",
      "country": "string"
    },
    "website": "string"
  },
  "settings": {
    "cardPayment": {
      "statementDescriptor": "string"
    },
    "achPayment": {
      "companyName": "string"
    }
  },
  "error": "string"
}

x-request-id


      
      string

required

A unique identifier used to trace requests.

Request was refused due to rate limiting.

x-request-id


      
      string

required

A unique identifier used to trace requests.

The request failed due to an unexpected error.

x-request-id


      
      string

required

A unique identifier used to trace requests.

The request failed because a downstream service failed to respond.

x-request-id


      
      string

required

A unique identifier used to trace requests.

Update an account

Response headers

Response headers

Response headers

Response headers

Response headers

Response headers

Response headers

Response headers

Response headers

Response headers