{"templateId":"../../../@theme/Templates/Wide.tsx","sharedDataIds":{"sidebar":"sidebar-guides/developer/errors/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-header","error-code-heading","section","panel-left","panel-right"]},"type":"markdown"},"seo":{"title":"Profile errors","siteUrl":"https://docs.wise.com","projectTitle":"Wise Platform","description":"Handle validation, conflict, address, and ownership errors for Wise profiles.","keywords":["profile errors","personal profile","business profile","profile validation"]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"profile-errors","__idx":0},"children":["Profile errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"class":"sub-header"},"children":["Handle personal and business profile validation errors."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Profile operations validate identity, contact, address, and business information. Treat the current operation schema as the source of truth for required fields. Process every returned error and use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["path"]}," to associate it with an input."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Response excerpts show only the entries for the named code from a documented response. The complete response can contain additional errors."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On this page:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#create-a-personal-profile"},"children":["Create a personal profile"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#create-a-business-profile"},"children":["Create a business profile"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#send-only-one-business-category-format"},"children":["Send only one business category format"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#handle-a-profile-conflict"},"children":["Handle a profile conflict"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#build-country-specific-addresses"},"children":["Build country-specific addresses"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#legacy-personal-profile-errors"},"children":["Legacy personal profile errors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#legacy-address-errors"},"children":["Legacy address errors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#handle-profile-error-messages"},"children":["Handle profile error messages"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/developer/errors#choose-a-recovery-action"},"children":["shared handling guidance"]}," for choosing an action, displaying messages, and retrying safely. Ask the customer to correct details only when they can edit them. If your integration supplies or changes those values, correct its validation or mapping instead."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-personal-profile","__idx":1},"children":["Create a personal profile"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /profiles/personal-profile"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/profile/profilepersonalcreate"},"children":["create a personal profile operation"]}," for the current request and response schema."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the current schema for required fields and process any returned validation items. The legacy identifiers listed later on this page are documented for different endpoints and should not be assumed to apply to this operation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-business-profile","__idx":2},"children":["Create a business profile"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /profiles/business-profile"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/profile/profilebusinesscreatev3"},"children":["create a business profile operation"]}," for the current request and response schema. The operation can return several field-specific ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api.*"]}," errors in one response."]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"api.businessName.missing"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request does not contain a business name."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["businessName"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Process every remaining error in the response."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after providing all required business fields."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (2026Q3)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"api.businessName.missing\",\n      \"message\": \"Please specify the name of your business\",\n      \"path\": \"businessName\",\n      \"arguments\": null\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"api.registrationNumber.missing"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A registration number is required for the selected company type."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["registrationNumber"]},", or confirm that the selected company type does not require one."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after correcting the registration details."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (2026Q3)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"api.registrationNumber.missing\",\n      \"message\": \"Please specify the registration number of your business \",\n      \"path\": \"registrationNumber\",\n      \"arguments\": null\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"api.industryCategories.invalid"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request does not contain at least one current, valid industry category."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["industryCategories"]}," using values accepted by the current operation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after correcting the category list."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (2026Q3)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"api.industryCategories.invalid\",\n      \"message\": \"Please provide at least one valid industry category\",\n      \"path\": \"industryCategories\",\n      \"arguments\": null\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"api.address.missing"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The required business address is absent."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide the address object and all fields required for its country."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after providing the address."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (2026Q3)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"api.address.missing\",\n      \"message\": \"Please specify the address of your business\",\n      \"path\": \"address\",\n      \"arguments\": null\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"api.companyType.missing"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request does not identify the business's company type."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide a supported ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companyType"]}," value."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after providing the company type."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (2026Q3)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"api.companyType.missing\",\n      \"message\": \"Please select a company type\",\n      \"path\": \"companyType\",\n      \"arguments\": null\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"api.businessName.invalid"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The business name contains content that the operation does not accept."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Correct ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["businessName"]}," using the returned message and current field constraints."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after correcting the business name."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (2026Q3)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"api.businessName.invalid\",\n      \"message\": \"Business name contains invalid characters\",\n      \"path\": \"businessName\",\n      \"arguments\": null\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"api.businessName.size.too.short"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The business name is shorter than the accepted minimum length."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide a non-empty ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["businessName"]}," that meets the current length constraint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after correcting the business name."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (2026Q3)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"api.businessName.size.too.short\",\n      \"message\": \"Business name must be at least 1 character long\",\n      \"path\": \"businessName\",\n      \"arguments\": null\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"api.companyType.invalid"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The supplied company type is not accepted by the operation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companyType"]}," with a supported current value."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after correcting the company type."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (2026Q3)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"api.companyType.invalid\",\n      \"message\": \"Invalid company type selected\",\n      \"path\": \"companyType\",\n      \"arguments\": null\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"api.industryCategories.forbidden"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One or more industry categories are not permitted for this profile."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check that the categories accurately describe the business. Correct a classification mistake; if the correct category is not permitted, ask Wise to confirm eligibility before resubmitting."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry only after correcting a classification mistake or resolving eligibility with Wise."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (2026Q3)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"api.industryCategories.forbidden\",\n      \"message\": \"One or more supplied industry categories is not permitted\",\n      \"path\": \"industryCategories\",\n      \"arguments\": null\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Validate owners and directors"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate every object in an owners or directors array."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide the complete identity, role, contact, and address data required by the current schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Process every returned error because different objects can fail for different reasons."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the returned ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["path"]}," to map the error to the correct person and field."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"send-only-one-business-category-format","__idx":3},"children":["Send only one business category format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoints:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /profiles/business-profile"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /profiles/{profileId}/business-profile"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["industryCategories"]}," and the deprecated ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["firstLevelCategory"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["secondLevelCategory"]}," pair are mutually exclusive. A request that supplies both is rejected with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["industryCategories"]}," path."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["industryCategories"]}," and omit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["firstLevelCategory"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["secondLevelCategory"]}," from the request entirely."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not send the new field alongside the legacy pair to move an existing profile across. Drop the legacy fields in the same request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apply the same rule on update. A request that changes both formats at once is rejected."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No dedicated error code is documented for this rejection. Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["industryCategories"]}," path to identify it rather than the message text."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the values accepted by each operation, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/product/account-setup/customer-onboarding/business-categories"},"children":["Wise business categories list"]},". To move an existing integration off the legacy pair, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/product/account-setup/customer-onboarding/migrate-business-profile-industry-categories"},"children":["Migrating to industry categories"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"handle-a-profile-conflict","__idx":4},"children":["Handle a profile conflict"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Profile creation can return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409"]}," when a matching profile already exists, particularly when the original request did not use an idempotency identifier."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["List the user's profiles before creating another one."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reconcile whether the original request succeeded."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reuse the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-idempotence-uuid"]}," only when retrying the same logical creation attempt."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not treat the status alone as a reusable error code. Add a returned identifier to this catalogue only after its public meaning is confirmed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"build-country-specific-addresses","__idx":5},"children":["Build country-specific addresses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before creating or updating an address:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/address/addressrequirementsget"},"children":["get address requirements operation"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Render the returned fields and validation constraints."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Preserve field names exactly when mapping the form to the request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Process every returned validation error."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Country requirements can change. Do not maintain a permanent client-side list as your only source of truth."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"legacy-personal-profile-errors","__idx":6},"children":["Legacy personal profile errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/profiles"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These identifiers are documented for the legacy profile operation. Their applicability to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /profiles/personal-profile"]}," is not established here."]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"BAD_REQUEST"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise cannot process the request structure or supplied object."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Compare the complete request with the legacy operation schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Correct unsupported profile data or incomplete nested objects."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after correcting the request."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example error response (POST /v1/profiles): missing details"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"BAD_REQUEST\",\n      \"message\": \"Missing details property\",\n      \"arguments\": []\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"MISSING"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A required identity, contact, or address field is absent or blank."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["path"]}," to identify the affected input."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apply the applicable country and profile requirements."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Process every missing field returned in the array."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after providing the required fields."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (POST /v1/profiles)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"MISSING\",\n      \"message\": \"Please enter your first name\",\n      \"path\": \"firstName\",\n      \"arguments\": [\n        \"firstName\"\n      ]\n    },\n    {\n      \"code\": \"MISSING\",\n      \"message\": \"Property [lastName] cannot be blank\",\n      \"path\": \"lastName\",\n      \"arguments\": [\n        \"lastName\"\n      ]\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"ERROR"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A field failed validation and the response uses a generic identifier. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["path"]}," to identify the affected field; the example shows an unparseable date of birth."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Compare the identified field with the legacy operation schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Correct the value using the applicable field requirements."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after correcting the identified field."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (POST /v1/profiles)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"ERROR\",\n      \"message\": \"Unparseable date\",\n      \"path\": \"dateOfBirth\",\n      \"arguments\": [\n        \"dateOfBirth\"\n      ]\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"TOO_SMALL"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A supplied value is shorter than its minimum accepted length."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["path"]}," to identify the field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Apply the current schema and any limits supplied in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arguments"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry after correcting the value."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (POST /v1/profiles)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"TOO_SMALL\",\n      \"message\": \"Value provided is too short. Please enter a valid phone number\",\n      \"path\": \"phoneNumber\",\n      \"arguments\": [\n        \"phoneNumber\",\n        \"+123\",\n        \"5\",\n        \"25\"\n      ]\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"UNEXPECTED"},"children":[]},{"$$mdtype":"Tag","name":"Section","attributes":{},"children":[{"$$mdtype":"Tag","name":"PanelLeft","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A value failed operation-specific validation without a more specific public identifier."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the endpoint, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["path"]},", and message together."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use a safe form-level fallback when no field is identified."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Record the response signature for monitoring."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry only after the request changes."]}]},{"$$mdtype":"Tag","name":"PanelRight","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response excerpt (POST /v1/profiles)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errors\": [\n    {\n      \"code\": \"UNEXPECTED\",\n      \"message\": \"Please enter a valid phone number\",\n      \"path\": \"phoneNumber\",\n      \"arguments\": [\n        \"phoneNumber\",\n        \"+123\"\n      ]\n    }\n  ]\n}\n","lang":"json"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"legacy-address-errors","__idx":7},"children":["Legacy address errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/addresses"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The published legacy address guide documents ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNEXPECTED_ERROR"]}," with HTTP ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}," for missing request details or a required postcode. Correct these known request defects before resubmitting; do not assume every ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}," is transient."]},{"$$mdtype":"Tag","name":"ErrorCodeHeading","attributes":{"code":"UNEXPECTED_ERROR"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wise encountered an unexpected validation or service failure."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What to do"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm that the request matches the current operation schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log a redacted response signature for investigation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not display diagnostic text directly to the end user."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retry conditions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Correct the missing details or required postcode before resubmitting. Reconcile an uncertain create result before repeating it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"handle-profile-error-messages","__idx":8},"children":["Handle profile error messages"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Display returned messages only for user-correctable input."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Map authentication, ownership, and service failures to safe messages."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not parse message text or use it for programmatic branching."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Redact identity, contact, address, and business data from logs."]}]}]},"headings":[{"value":"Profile errors","id":"profile-errors","depth":1},{"value":"Create a personal profile","id":"create-a-personal-profile","depth":2},{"value":"Create a business profile","id":"create-a-business-profile","depth":2},{"value":"Send only one business category format","id":"send-only-one-business-category-format","depth":2},{"value":"Handle a profile conflict","id":"handle-a-profile-conflict","depth":2},{"value":"Build country-specific addresses","id":"build-country-specific-addresses","depth":2},{"value":"Legacy personal profile errors","id":"legacy-personal-profile-errors","depth":2},{"value":"Legacy address errors","id":"legacy-address-errors","depth":2},{"value":"Handle profile error messages","id":"handle-profile-error-messages","depth":2}],"frontmatter":{"template":"../../../@theme/Templates/Wide.tsx","seo":{"title":"Profile errors","description":"Handle validation, conflict, address, and ownership errors for Wise profiles.","keywords":["profile errors","personal profile","business profile","profile validation"]},"markdown":{"toc":{"hide":true}}},"lastModified":"2026-09-24T12:43:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/developer/errors/profiles","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}