This API has been deprecated. Please migrate to v20260326 to access additional features and improved security.
Create a beneficiary creation intent
UAT Env
https://uat.fomoapis.com/v1
UAT Env
https://uat.fomoapis.com/v1
POST
https://uat.fomoapis.com/v1
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://uat.fomoapis.com/v1/intents/beneficiary-creation' \
--header 'x-fomo-api-version;' \
--header 'Content-Type: application/json' \
--data '{
"country_code": "HK",
"name": "Andy Lim",
"address": "Victoria Hong Kong",
"type": "individual"
}'Response Response Example
{
"id": "01985ac2-2531-7b10-b3a9-007073d29b0f",
"create_time": "2025-07-30T09:55:29.775165152+00:00",
"update_time": "2025-07-30T09:55:29.775165152+00:00",
"token": "AZhawiUxexCzqQBwc9KbDw==",
"etag": "AZhawiUxexCzqQBwc9KbDwAAAAAAAAAA",
"life_cycle": "pending-requirements",
"result": "pending",
"fail_reason": null,
"customer_id": "725040eb-ed2c-4926-967c-39c8769eb622",
"country_code": "HK",
"name": "Andy Lim",
"address": "Victoria Hong Kong",
"type": "individual",
"requirements": [],
"submitted_requirements": [],
"confirm_time": null,
"approve_time": null,
"complete_time": null,
"beneficiary_id": null
}