Create a virtual account creation intent

UAT Env

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

POST

/virtual-account-creation-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-creation-intents' \
--header 'x-fomo-api-version: v20260326' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "account_id": "d810e529-1daf-4e1e-bcd0-d7a253e6babb"
}'

Response Example

{
    "id": "019fdbc7-ba90-7ff1-ae58-bbe43fa9d79f",
    "create_time": "2026-08-07T10:32:07.654662+00:00",
    "update_time": "2026-08-07T10:32:07.654662+00:00",
    "token": "AZ_bx7qQf_GuWLvkP6nXnw",
    "etag": "\"AZ_bx7qQf_GuWLvkP6nXnwAAAAAAAAAA\"",
    "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": [
        "account-name",
        "external-account"
    ],
    "submitted_requirements": [],
    "confirm_time": null,
    "approve_time": null,
    "complete_time": null,
    "virtual_account_id": null,
    "account_holder_id": null,
    "account_name": null,
    "external_account": null,
    "supporting_information": []
}

List outgoing transfer creation intents

Set account holder for virtual account creation intent