Set external account for virtual account creation intent

UAT Env

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

PATCH

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

Choose a preferred external account instead of having one assigned automatically. Intent will fail when the specified external account is not compatible or is not available.

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/external-account' \
--header 'If-Match;' \
--header 'x-fomo-api-version: v20260326' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "external_account": {
        "type": "crypto-account",
        "detail": {
            "chain": "ethereum:sepolia",
            "address": "0xd38618797e40cf1A0fE171eA14E5f3B3A75D07e6"
        }
    }
}'

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": [
        "external-account"
    ],
    "confirm_time": null,
    "approve_time": null,
    "complete_time": null,
    "virtual_account_id": null,
    "account_holder_id": null,
    "account_name": null,
    "external_account": {
        "type": "crypto-account",
        "detail": {
            "chain": "ethereum:sepolia",
            "address": "0xd38618797e40cf1A0fE171eA14E5f3B3A75D07e6"
        }
    },
    "supporting_information": []
}

Set account name for virtual account creation intent

Confirm a virtual account creation intent