{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Fin.com","colors":{"primary":"#151515","light":"#ffffff","dark":"#151515"},"logo":{"light":"https://mintcdn.com/fincom/969Z7MrQZfZxl5Xb/logo/fin-light.svg?fit=max\u0026auto=format\u0026n=969Z7MrQZfZxl5Xb\u0026q=85\u0026s=cb3c849e51c2ab3fda0b143cc6353936","dark":"https://mintcdn.com/fincom/I3xrdkmgSvHEQjsK/images/White.png?fit=max\u0026auto=format\u0026n=I3xrdkmgSvHEQjsK\u0026q=85\u0026s=e982af476e1a852cbc16b7ac0c68ebbd"},"favicon":"https://mintcdn.com/fincom/I3xrdkmgSvHEQjsK/images/Blackinwhitebg.png?fit=max\u0026auto=format\u0026n=I3xrdkmgSvHEQjsK\u0026q=85\u0026s=0638bb3258114351e78b1d690a05fc25","api":{"playground":{"display":"interactive","proxy":true},"examples":{"languages":["curl","node","java","python","go"]}},"appearance":{"default":"dark","strict":false},"background":{"color":{"dark":"#151515"}},"navbar":{"links":[],"primary":{"type":"button","label":"Orchestration Dashboard","href":"https://orchestration.fin.com"}},"footer":{"socials":{}},"fonts":{"family":"Inter","weight":400},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/fincom/I3xrdkmgSvHEQjsK/images/Thumbnail.png?fit=max\u0026auto=format\u0026n=I3xrdkmgSvHEQjsK\u0026q=85\u0026s=d1db2312970fc0515f006c134c6a601d"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fincom","hasAudioNarration":false,"actualSubdomain":"fincom","customDomains":["developer.fin.com"],"gitSource":{"type":"github","owner":"0xavalon","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af60e416797c34e7372595c","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"Guides","count":39},{"language":"default","tag":"Transactions","count":23},{"language":"default","tag":"Changelogs","count":22},{"language":"default","tag":"Beneficiaries","count":15},{"language":"default","tag":"Customers","count":14},{"language":"default","tag":"Webhooks","count":13},{"language":"default","tag":"Customers and compliance","count":11},{"language":"default","tag":"Create now, settle later","count":8},{"language":"default","tag":"Crypto Orchestration (Special use case)","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/webhooks/beneficiary-created","slug":"/api-reference/webhooks/beneficiary-created","pageMetadata":{"openapi":"WEBHOOK beneficiary.created","title":"Beneficiary Created","description":"Triggered when a new beneficiary is created in the system.","href":"/api-reference/webhooks/beneficiary-created"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Triggered when a new beneficiary is created in the system.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"WEBHOOK beneficiary.created","title":"Beneficiary Created","description":"Triggered when a new beneficiary is created in the system.","href":"/api-reference/webhooks/beneficiary-created"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Beneficiary Created","description":"Triggered when a new beneficiary is created in the system.","x-mint":{"metadata":{"title":"beneficiary.created"},"content":"\u003cNote>\n All webhook requests include HMAC signatures for verification.\n\u003c/Note>\n"},"tags":["Webhooks"],"requestBody":"ccaa9329-7a7e-43c5-9952-28dbcb726ef3","responses":{"200":"9206dc55-92e2-4ca1-8a5f-828fa9715cc5"},"method":"post","type":"webhook","servers":["5e8baf91-45fb-4426-a340-2b153b613626","3d314cc3-8108-4fb7-bd08-c3c322c8575e"],"security":[],"path":"beneficiary.created","baseUrlOptions":["https://sandbox.api.fin.com","https://api.fin.com"],"title":"Beneficiary Created","codeSamples":[],"requestExampleLanguages":["bash","node","java","python","go"],"requiredOnlyExamples":false,"requestExamples":[{"language":"json","filename":"individualCreated","code":"{\n \"event\": {\n \"id\": \"85804b3a-bf18-4d87-94f3-f7c45e66868e\",\n \"event_reference_id\": \"4d715f20-f704-45e0-af56-19ade318e852\",\n \"type\": \"beneficiary.created\",\n \"created_at\": \"2025-12-10T10:36:18.279837Z\",\n \"sandbox_mode\": true\n },\n \"data\": {\n \"active\": true,\n \"beneficiary_id\": \"4d715f20-f704-45e0-af56-19ade318e852\",\n \"customer_id\": \"efb54adf-b7f4-4716-80e3-806e11f20b7b\",\n \"type\": \"INDIVIDUAL\"\n }\n}"}],"requestExampleType":"webhook","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","required":["id","event_reference_id","type","created_at","sandbox_mode"],"properties":{"id":{"type":"string","format":"uuid","example":"60bef15c-4e30-4eb4-bc4d-aa697a7e0857","isRequired":true,"uniqueKey":"event.id","typeLabel":"string\u003cuuid>"},"event_reference_id":{"type":"string","format":"uuid","example":"c3309534-1517-4d15-b244-be8f943c3823","isRequired":true,"uniqueKey":"event.event_reference_id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["beneficiary.created"],"example":"beneficiary.created","isRequired":true,"uniqueKey":"event.type","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","example":"2025-11-30T07:40:06.853938Z","isRequired":true,"uniqueKey":"event.created_at","typeLabel":"string\u003cdate-time>"},"sandbox_mode":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"event.sandbox_mode","typeLabel":"boolean"}},"uniqueKey":"event","typeLabel":"object"},"data":{"type":"object","properties":{"beneficiary_id":{"type":"string","format":"uuid","example":"e8fccaeb-fb9d-4fae-846e-ea7c97c70b31","uniqueKey":"data.beneficiary_id","typeLabel":"string\u003cuuid>"},"customer_id":{"type":"string","format":"uuid","example":"ecbd3a73-3bcb-40ae-be06-0e71f9b27c2f","uniqueKey":"data.customer_id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["INDIVIDUAL","BUSINESS"],"example":"INDIVIDUAL","uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"active":{"type":"boolean","example":true,"uniqueKey":"data.active","typeLabel":"boolean"},"status":{"type":"string","enum":["PROCESSING","ACTIVE","INACTIVE","REJECTED"],"example":"ACTIVE","uniqueKey":"data.status","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"individualCreated":{"title":"individualCreated","summary":"Individual Beneficiary Created","value":{"event":{"id":"85804b3a-bf18-4d87-94f3-f7c45e66868e","event_reference_id":"4d715f20-f704-45e0-af56-19ade318e852","type":"beneficiary.created","created_at":"2025-12-10T10:36:18.279837Z","sandbox_mode":true},"data":{"active":true,"beneficiary_id":"4d715f20-f704-45e0-af56-19ade318e852","customer_id":"efb54adf-b7f4-4716-80e3-806e11f20b7b","type":"INDIVIDUAL"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"9206dc55-92e2-4ca1-8a5f-828fa9715cc5":{"description":"Webhook received successfully","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{},"servers":{"5e8baf91-45fb-4426-a340-2b153b613626":{"url":"https://sandbox.api.fin.com","description":"Sandbox server"},"3d314cc3-8108-4fb7-bd08-c3c322c8575e":{"url":"https://api.fin.com","description":"Production server"}}},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"fincom","siteName":"Fin.com","title":"Beneficiary Created - Fin.com","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-10T09:52:51.545Z","originalFileLocation":"api-reference/webhooks/beneficiary-created.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Triggered when a new beneficiary is created in the system.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fin.com\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fincom/0W5vAdwXlftJso9s/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/fincom/0W5vAdwXlftJso9s/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fincom/0W5vAdwXlftJso9s/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fincom/0W5vAdwXlftJso9s/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fincom/0W5vAdwXlftJso9s/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fincom/0W5vAdwXlftJso9s/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fincom/0W5vAdwXlftJso9s/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fincom/0W5vAdwXlftJso9s/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fincom/0W5vAdwXlftJso9s/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Beneficiary Created - Fin.com\">\u003cmeta data-mint-head property=\"og:description\" content=\"Triggered when a new beneficiary is created in the system.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fin.com\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.fin.com/api-reference/webhooks/beneficiary-created\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fincom.mintlify.site/_mintlify/api/og/v2?division=Beneficiaries\u0026amp;title=Beneficiary+Created\u0026amp;description=Triggered+when+a+new+beneficiary+is+created+in+the+system.\u0026amp;theme=b91c5f282d6b0107e9863b2a\u0026amp;signature=825ddd1c84c3213eb80c937b47da140859e19ffb35d189b3ddfee06399df7072\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Beneficiary Created - Fin.com\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Triggered when a new beneficiary is created in the system.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fincom.mintlify.site/_mintlify/api/og/v2?division=Beneficiaries\u0026amp;title=Beneficiary+Created\u0026amp;description=Triggered+when+a+new+beneficiary+is+created+in+the+system.\u0026amp;theme=b91c5f282d6b0107e9863b2a\u0026amp;signature=825ddd1c84c3213eb80c937b47da140859e19ffb35d189b3ddfee06399df7072\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/fincom/0W5vAdwXlftJso9s/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fin.com\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#151515\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.fin.com/api-reference/webhooks/beneficiary-created\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/webhooks/beneficiary-created.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.fin.com/#organization\",\"name\":\"Fin.com\",\"url\":\"https://developer.fin.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fincom/969Z7MrQZfZxl5Xb/logo/fin-light.svg?fit=max\u0026auto=format\u0026n=969Z7MrQZfZxl5Xb\u0026q=85\u0026s=cb3c849e51c2ab3fda0b143cc6353936\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.fin.com#website\",\"name\":\"Fin.com\",\"url\":\"https://developer.fin.com\",\"publisher\":{\"@id\":\"https://developer.fin.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.fin.com/api-reference/webhooks/beneficiary-created#webpage\",\"url\":\"https://developer.fin.com/api-reference/webhooks/beneficiary-created\",\"name\":\"Beneficiary Created\",\"description\":\"Triggered when a new beneficiary is created in the system.\",\"dateModified\":\"2026-06-10T09:52:51.545Z\",\"isPartOf\":{\"@id\":\"https://developer.fin.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.fin.com/api-reference/webhooks/beneficiary-created#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.fin.com/api-reference/webhooks/beneficiary-created#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Webhooks\",\"item\":\"https://developer.fin.com/api-reference/webhooks/customer-created\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Beneficiary Created\",\"item\":\"https://developer.fin.com/api-reference/webhooks/beneficiary-created\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.fin.com/api-reference/webhooks/beneficiary-created#apireference\",\"headline\":\"Beneficiary Created\",\"name\":\"Beneficiary Created\",\"description\":\"Triggered when a new beneficiary is created in the system.\",\"url\":\"https://developer.fin.com/api-reference/webhooks/beneficiary-created\",\"mainEntityOfPage\":{\"@id\":\"https://developer.fin.com/api-reference/webhooks/beneficiary-created#webpage\"},\"dateModified\":\"2026-06-10T09:52:51.545Z\",\"publisher\":{\"@id\":\"https://developer.fin.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.fin.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fin.com\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Fin.com\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/webhooks/beneficiary-created.md","siteName":"Fin.com","nav":{"global":null,"tabs":[{"tab":"Main Site","href":"https://fin.com"},{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","pages":[{"group":"Authentication","pages":[{"openapi":"POST /v1/oauth/token","title":"Issue a Token","href":"/api-reference/authentication/issue-a-token"},{"openapi":"POST /v1/oauth/refresh-token","title":"Refresh a Token","href":"/api-reference/authentication/refresh-a-token"}]},{"group":"Customers","pages":[{"group":"Create Individual Customer","expanded":false,"pages":[{"openapi":"POST /v2/customers/individual","title":"Create Individual Customer","href":"/api-reference/customers/create-individual-customer-v2"},{"openapi":"POST /v2/customers/{customer_id}/individual/attach","title":"Attach Documents to Individual Customer","href":"/api-reference/customers/attach-documents-to-individual-customer-v2"}]},{"group":"Create Business Customer","expanded":false,"pages":[{"openapi":"POST /v2/customers/business","title":"Create Business Customer","href":"/api-reference/customers/create-business-customer-v2"},{"openapi":"POST /v2/customers/{customer_id}/business/attach","title":"Attach Documents to Business Customer","href":"/api-reference/customers/attach-documents-to-business-customer-v2"},{"openapi":"POST /v2/customers/{customer_id}/associated-parties/individual/attach","title":"Attach Documents to Associated Party","href":"/api-reference/customers/attach-documents-to-associated-party-v2"}]},{"openapi":"GET /v2/customers/{customer_id}","title":"Get Customer Details","href":"/api-reference/customers/get-customer-details-v2"},{"openapi":"GET /v2/customers","title":"List Customers","href":"/api-reference/customers/list-customers-v2"},{"openapi":"GET /v2/customers/{customer_id}/capabilities","title":"Get Customer Capabilities","href":"/api-reference/customers/get-customer-capabilities"},{"title":"Get Required Documents","openapi":"GET /v2/customers/required-documents","href":"/api-reference/customers/get-required-documents"},{"openapi":"POST /v1/customers/upload","title":"Upload Document","href":"/api-reference/customers/upload-document"},{"openapi":"PATCH /v1/customers/{customer_id}","title":"Patch Customer RFI","href":"/api-reference/customers/patch-customer-rfi"}]},{"group":"Beneficiaries","pages":[{"group":"Create Beneficiary","expanded":false,"pages":[{"openapi":"POST /v3/beneficiaries","title":"Create Beneficiary V3","href":"/api-reference/beneficiaries/create-beneficiary-v3"},{"openapi":"POST /v2/beneficiaries","title":"Create Beneficiary V2","href":"/api-reference/beneficiaries/create-beneficiary-v2"},{"openapi":"GET /v1/beneficiaries/countries","title":"List Available Countries","href":"/api-reference/beneficiaries/list-available-countries"},{"openapi":"GET /v1/beneficiaries/methods","title":"List Bank Identifiers","href":"/api-reference/beneficiaries/list-bank-identifiers"},{"openapi":"GET /v1/beneficiaries/methods/{method_id}/branches","title":"List Bank Branch Identifiers","href":"/api-reference/beneficiaries/list-bank-branch-identifiers"}]},{"openapi":"GET /v2/beneficiaries/details","title":"Fetch Beneficiary Details","href":"/api-reference/beneficiaries/fetch-beneficiary-details-v2"},{"openapi":"GET /v1/customers/{customer_id}/beneficiaries","title":"List Beneficiaries For a Customer","href":"/api-reference/beneficiaries/list-beneficiaries-for-a-customer"},{"openapi":"PATCH /v1/beneficiaries","title":"Update Beneficiary Active Status","href":"/api-reference/beneficiaries/update-beneficiary-active-status"},{"openapi":"POST /v1/beneficiaries/{beneficiary_id}/documents","title":"Upload Beneficiary Documents","href":"/api-reference/beneficiaries/upload-beneficiary-documents"}]},{"group":"Virtual Accounts","pages":[{"group":"Create Virtual Account","expanded":false,"pages":[{"openapi":"POST /v3/customers/{customer_id}/virtual-accounts","title":"Create Virtual Account V3","href":"/api-reference/virtual-accounts/create-virtual-account-v3"},{"openapi":"POST /v2/customers/{customer_id}/virtual-accounts","title":"Create Virtual Account V2","href":"/api-reference/virtual-accounts/create-virtual-account-v2"}]},{"openapi":"GET /v3/customers/{customer_id}/virtual-accounts","title":"List Virtual Accounts","href":"/api-reference/virtual-accounts/list-virtual-accounts-v3"},{"openapi":"GET /v3/customers/{customer_id}/virtual-accounts/{va_id}","title":"Get Virtual Account Details","href":"/api-reference/virtual-accounts/get-virtual-account-details"},{"openapi":"GET /v1/virtual-account/{virtual_account_id}/transactions","title":"Fetch Virtual Account Transactions","href":"/api-reference/virtual-accounts/fetch-virtual-account-transactions"}]},{"group":"Transactions","pages":[{"group":"Create now, settle later","expanded":false,"pages":[{"openapi":"POST /v3/transactions/transfer-payout","title":"Create a Transfer V3","href":"/api-reference/transactions/create-a-transfer-v3"},{"openapi":"POST /v1/transactions/transfer-payout","title":"Create a Transfer","href":"/api-reference/transactions/create-a-transfer"},{"openapi":"POST /v2/transactions/transfer-payout","title":"Create a Transfer V2","href":"/api-reference/transactions/create-a-transfer-v2"},{"openapi":"POST /v3/transactions/transfer-payout/settle","title":"Settle a Transfer V3","href":"/api-reference/transactions/settle-a-transfer-v3"},{"openapi":"POST /v1/transactions/transfer-payout/settle","title":"Settle a Transfer","href":"/api-reference/transactions/settle-a-transfer"},{"openapi":"POST /v2/transactions/transfer-payout/settle","title":"Settle a Transfer V2","href":"/api-reference/transactions/settle-a-transfer-v2"},{"openapi":"GET /v2/transactions/transfer-payout/{transfer_id}","title":"Fetch a Transfer V2","href":"/api-reference/transactions/fetch-a-transfer-v2"},{"openapi":"POST /v1/beneficiaries/{beneficiary_id}/documents","title":"Upload Beneficiary Documents","href":"/api-reference/transactions/upload-beneficiary-documents"}]},{"group":"Batch Transfer","expanded":false,"pages":[{"openapi":"POST /v3/batch/transactions/commit","title":"Execute Batch Transfer V3","href":"/api-reference/transactions/execute-batch-transfer-v3"},{"openapi":"POST /v1/batch/transactions/commit","title":"Execute Batch Transfer","href":"/api-reference/transactions/execute-batch-transfer"},{"openapi":"GET /v1/batch/transactions/commit/{batch_id}","title":"Fetch Batch Details","href":"/api-reference/transactions/fetch-batch-details"}]},{"group":"Crypto Transfer","expanded":false,"pages":[{"openapi":"POST /v3/transactions/quote","title":"Create Quote V3","href":"/api-reference/transactions/create-quote-v3"},{"openapi":"POST /v2/transactions/quote","title":"Create Quote","href":"/api-reference/transactions/create-quote"},{"openapi":"POST /v3/transactions","title":"Execute Quote V3","href":"/api-reference/transactions/execute-quote-v3"},{"openapi":"POST /v2/transactions","title":"Execute Quote","href":"/api-reference/transactions/execute-quote"}]},{"group":"Transactions List","expanded":false,"pages":[{"openapi":"GET /v3/transactions","title":"List Customer Transactions V3","href":"/api-reference/transactions/list-customer-transactions-v3"},{"openapi":"GET /v2/transactions","title":"List Customer Transactions","href":"/api-reference/transactions/list-customer-transactions"},{"openapi":"GET /v1/beneficiaries/{beneficiary_id}/transactions","title":"List Beneficiary Transactions","href":"/api-reference/transactions/list-beneficiary-transactions"}]},{"group":"Transaction Details","expanded":false,"pages":[{"openapi":"GET /v3/transactions/{transaction_id}","title":"Fetch Transaction Details V3","href":"/api-reference/transactions/fetch-transaction-details-v3"},{"openapi":"GET /v2/transactions/{transaction_id}","title":"Fetch Transaction Details","href":"/api-reference/transactions/fetch-transaction-details-v2"}]}]},{"group":"Balances","pages":[{"openapi":"GET /v1/wallet/balances","title":"Fetch Prefunded Balance","href":"/api-reference/balances/fetch-prefunded-balance"}]},{"group":"Fees \u0026 FX Rates","pages":[{"openapi":"GET /v1/fx-rate","title":"Fetch Exchange Rates","href":"/api-reference/fees-and-fx-rates/fetch-exchange-rates"},{"openapi":"POST /v1/fee-calculation","title":"Calculate Exchange Rates","href":"/api-reference/fees-and-fx-rates/calculate-exchange-rates"}]},{"group":"Catalogue","pages":[{"group":"All Catalogues","expanded":false,"pages":[{"openapi":"GET /v1/occupations","title":"List Occupations","href":"/api-reference/catalogue/list-occupations"},{"openapi":"GET /v1/source-of-funds","title":"List Source of Funds","href":"/api-reference/catalogue/list-source-of-funds"},{"openapi":"GET /v1/source-of-wealth","title":"List Source of Wealth","href":"/api-reference/catalogue/list-source-of-wealth"},{"openapi":"GET /v1/purposes","title":"List Account Purposes","href":"/api-reference/catalogue/list-account-purposes"},{"title":"List Generic Country Codes","openapi":"GET /v1/countries","href":"/api-reference/catalogue/list-countries"},{"openapi":"GET /v1/countries/{country_code}/subdivisions","title":"List Subdivision Codes: ISO 3166-1 alpha-2","href":"/api-reference/catalogue/list-subdivisions"},{"openapi":"GET /v1/transaction-purposes","title":"List Transaction Purposes","href":"/api-reference/catalogue/list-transaction-purposes"}]}]},{"group":"Crypto Orchestration","pages":[{"openapi":"POST /v1/transit/quote","title":"Create a crypto payment quote","href":"/api-reference/crypto-orchestration/create-a-crypto-payment-quote"},{"openapi":"POST /v1/transit/payment","title":"Create a Payment","href":"/api-reference/crypto-orchestration/create-a-payment"},{"openapi":"GET /v1/transit/payment/{payment_id}","title":"Fetch a Payment","href":"/api-reference/crypto-orchestration/fetch-a-payment"}]},{"group":"Webhooks","pages":[{"group":"Customers","expanded":false,"pages":[{"openapi":"WEBHOOK customer.created","title":"Customer Created","href":"/api-reference/webhooks/customer-created"},{"openapi":"WEBHOOK customer.status","title":"Customer Status","href":"/api-reference/webhooks/customer-status"},{"openapi":"WEBHOOK customer.rfi","title":"Customer RFI","description":"Triggered when the compliance team requests additional information or documents from a customer. Sets the customer status to ACTION_REQUIRED. The payload includes a structured list of what is missing, invalid, or expired, scoped to either the customer or a specific associated party.","href":"/api-reference/webhooks/customer-rfi"}]},{"group":"Beneficiaries","expanded":false,"pages":[{"openapi":"WEBHOOK beneficiary.created","title":"Beneficiary Created","href":"/api-reference/webhooks/beneficiary-created"},{"openapi":"WEBHOOK beneficiary.status","title":"Beneficiary Status","description":"Triggered when a beneficiary's status changes.","href":"/api-reference/webhooks/beneficiary-status"}]},{"group":"Virtual Accounts","expanded":false,"pages":[{"openapi":"WEBHOOK virtual_account.created.v2","title":"Virtual Account Created V2","href":"/api-reference/webhooks/virtual-account-created-v2"},{"openapi":"WEBHOOK virtual_account.status.v2","title":"Virtual Account Status V2","href":"/api-reference/webhooks/virtual-account-status-v2"}]},{"group":"Transactions","expanded":false,"pages":[{"openapi":"WEBHOOK transaction.status","title":"Transaction Status","href":"/api-reference/webhooks/transaction-status"},{"openapi":"WEBHOOK beneficiary.liquidation.deposit","title":"Beneficiary Liquidation Deposit","href":"/api-reference/webhooks/beneficiary-liquidation-deposit"},{"openapi":"WEBHOOK batch.transaction.item.status","title":"Batch Transaction Item Status","href":"/api-reference/webhooks/batch-transaction-item-status"}]},{"group":"Payments","expanded":false,"pages":[{"openapi":"WEBHOOK transit.payment.status","title":"Transit Payment Status","href":"/api-reference/webhooks/transit-payment-status"}]}]}]},{"tab":"Changelogs","pages":[{"title":"Changelogs","href":"/changelogs/2026-10-27"}]},{"tab":"FAQs","pages":[{"title":"FAQs","href":"/faqs"}]}]},"basePath":"","title":"Beneficiary Created - Fin.com","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-BIYvYBgk.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}