Create a virtual account update intent

UAT Env

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

POST

/virtual-account-update-intents

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://treasury.uat.fomoapis.com/v1/virtual-account-update-intents' \
--header 'x-fomo-api-version: v20260326' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "virtual_account_id": "74fa3bd4-07cc-4c57-9bed-5f46514fe694"
}'

Response Example

{
    "id": "019fdbc8-d521-7d31-b26b-b587398c1e2e",
    "create_time": "2026-08-07T10:33:20.059559+00:00",
    "update_time": "2026-08-07T10:33:20.059559+00:00",
    "token": "AZ_byNUhfTGya7WHOYweLg",
    "etag": "\"AZ_byNUhfTGya7WHOYweLgAAAAAAAAAA\"",
    "life_cycle": "pending-requirements",
    "result": "pending",
    "fail_reason": null,
    "customer_id": "725040eb-ed2c-4926-967c-39c8769eb622",
    "virtual_account_id": "74fa3bd4-07cc-4c57-9bed-5f46514fe694",
    "requirements": [],
    "optional_requirements": [
        "account-name"
    ],
    "submitted_requirements": [],
    "confirm_time": null,
    "approve_time": null,
    "complete_time": null,
    "account_name": null,
    "supporting_information": []
}

List virtual account creation intents

Set account name for virtual account update intent