Set account holder for virtual account creation intent

UAT Env

https://treasury.uat.fomoapis.com/v1

PATCH

/virtual-account-creation-intents/{virtual_account_creation_intent_id}/account-holder

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://treasury.uat.fomoapis.com/v1/virtual-account-creation-intents/0195282b-cd32-7250-92f1-1953c243e5ba/account-holder' \
--header 'If-Match;' \
--header 'x-fomo-api-version: v20260326' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "account_holder_id": "88f768c3-5bd8-4140-af5f-b4b010608e7d"
}'

Response Example

{
    "id": "019fdbc7-ba90-7ff1-ae58-bbe43fa9d79f",
    "create_time": "2026-08-07T10:32:07.654662+00:00",
    "update_time": "2026-08-07T10:32:20.288084+00:00",
    "token": "AZ_bx7qQf_GuWLvkP6nXnw",
    "etag": "\"AZ_bx7qQf_GuWLvkP6nXnwAAAAAAAAAB\"",
    "life_cycle": "pending-requirements",
    "result": "pending",
    "fail_reason": null,
    "customer_id": "725040eb-ed2c-4926-967c-39c8769eb622",
    "account_id": "d810e529-1daf-4e1e-bcd0-d7a253e6babb",
    "requirements": [
        "account-holder"
    ],
    "optional_requirements": [
        "external-account",
        "account-name"
    ],
    "submitted_requirements": [
        "account-holder"
    ],
    "confirm_time": null,
    "approve_time": null,
    "complete_time": null,
    "virtual_account_id": null,
    "account_holder_id": "88f768c3-5bd8-4140-af5f-b4b010608e7d",
    "account_name": null,
    "external_account": null,
    "supporting_information": []
}

Create a virtual account creation intent

Set account name for virtual account creation intent