{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Convoy","colors":{"primary":"#2780F1","light":"#739FEA","dark":"#477BD3"},"logo":{"light":"https://mintcdn.com/convoy/ZDnFuM112cm76jYI/logo/light.svg?fit=max\u0026auto=format\u0026n=ZDnFuM112cm76jYI\u0026q=85\u0026s=3d933080cf301678d7fafe5f50d4ec12","dark":"https://mintcdn.com/convoy/vmJyPsa9GtTKdw-a/logo/dark.svg?fit=max\u0026auto=format\u0026n=vmJyPsa9GtTKdw-a\u0026q=85\u0026s=7d0ea6ef778d7ed00854dc455e9b12ea"},"favicon":"https://mintcdn.com/convoy/Ckv6F6QCAG1QB-UF/favicon.png?fit=max\u0026auto=format\u0026n=Ckv6F6QCAG1QB-UF\u0026q=85\u0026s=cc975351cd155c7828899933dca4f999","background":{"image":"https://mintcdn.com/convoy/Ckv6F6QCAG1QB-UF/background.png?fit=max\u0026auto=format\u0026n=Ckv6F6QCAG1QB-UF\u0026q=85\u0026s=165fcf2460dff22b7e1c8d84d0741646"},"navbar":{"primary":{"type":"github","label":"GitHub","href":"https://github.com/frain-dev/convoy"}},"footer":{"socials":{"twitter":"https://twitter.com/getconvoy?lang=en","linkedin":"https://www.linkedin.com/company/convoy-webhooks"}},"seo":{"metatags":{"canonical":"https://www.getconvoy.io/docs"}},"integrations":{"posthog":{"apiKey":"phc_X7uV1sRNzjoTmWp8uXYrzrfrdUtGdMRTEEklRNt04eb","apiHost":"https://us.i.posthog.com"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://convoy-community.slack.com/join/shared_invite/zt-xiuuoj0m-yPp~ylfYMCV9s038QL0IUQ#/shared-invite/email"},{"anchor":"GitHub","icon":"github","href":"https://github.com/frain-dev/convoy"},{"anchor":"Status","icon":"signal","href":"https://status.getconvoy.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"convoy","hasAudioNarration":false,"actualSubdomain":"convoy","customDomains":["getconvoy.io"],"gitSource":{"type":"github","owner":"frain-dev","repo":"convoy-website","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae50032dbe71608b89029e5","collectionId":"118644cb-011e-4922-8a20-f36a66055bb0","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae50032dbe71608b89029e5"},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae50032dbe71608b89029e5","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":70},{"language":"default","tag":"Documentation","count":68},{"language":"default","tag":"Product Manual","count":28},{"language":"default","tag":"Glossary","count":13},{"language":"default","tag":"Endpoints","count":9},{"language":"default","tag":"Events","count":8},{"language":"default","tag":"Subscription Filters","count":8},{"language":"default","tag":"Deployment","count":8},{"language":"default","tag":"Subscriptions","count":7},{"language":"default","tag":"Portal Links","count":6}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"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":"llms-txt-v2","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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/events/fan-out-an-event","slug":"/api-reference/events/fan-out-an-event","pageMetadata":{"openapi":"post /v1/projects/{projectID}/events/fanout","title":"Fan out an event","description":"This endpoint uses the owner_id to fan out an event to multiple endpoints.","href":"/api-reference/events/fan-out-an-event"},"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: \"This endpoint uses the owner_id to fan out an event to multiple endpoints.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`201`}),` body includes `,_jsx(_components.code,{children:`uid`}),` (the event id). Use it to follow the send:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/api-reference/events/retrieve-an-event`,children:`Retrieve the event`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/event-deliveries/list-all-event-deliveries`,children:`List deliveries`}),` (`,_jsx(_components.code,{children:`eventId`}),` or `,_jsx(_components.code,{children:`idempotencyKey`}),`)`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/api-reference/event-deliveries/retrieve-an-event-delivery`,children:`Get a delivery`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/api-reference/event-deliveries/retry-event-delivery`,children:`Retry a delivery`})}),`\n`]})]})}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":"post /v1/projects/{projectID}/events/fanout","title":"Fan out an event","description":"This endpoint uses the owner_id to fan out an event to multiple endpoints.","href":"/api-reference/events/fan-out-an-event"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"parameters":["ba2e7f25-b6cf-4e9a-98cd-d00b8dcc98db"],"responses":{"201":"7647e6ad-d462-4ac0-9e00-e64871a513f7","400":"c146dcab-6a24-4c68-a7a1-8d5b74eeba8f","401":"073b5744-2372-41bd-90f5-137bb6a58ad5","404":"004da6e5-111f-4dee-bc57-3a7554000dad"},"security":["8f2252f8-e0e6-4fa2-8600-bc1d7de044d2"],"tags":["Events"],"description":"This endpoint uses the owner_id to fan out an event to multiple endpoints.","operationId":"CreateEndpointFanoutEvent","requestBody":"51764674-5c1a-4c66-b25e-fa107f9be697","summary":"Fan out an event","method":"post","type":"path","servers":["ea05ed13-6fe8-4fcf-a55a-7dd4fbef101c","88107b80-52be-4d32-be46-16468ea6dbc5"],"path":"/v1/projects/{projectID}/events/fanout","baseUrlOptions":["https://us.getconvoy.cloud/api","https://eu.getconvoy.cloud/api"],"title":"Fan out an event","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ba2e7f25-b6cf-4e9a-98cd-d00b8dcc98db":{"description":"Project ID","in":"path","name":"projectID","required":true,"schema":{"type":"string","isRequired":true,"description":"Project ID","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"properties":{"custom_headers":{"additionalProperties":{"type":"string","uniqueKey":"custom_headers.additionalProperties","typeLabel":"string"},"description":"Specifies custom headers you want convoy to add when the event is dispatched to your endpoint","type":"object","uniqueKey":"custom_headers","typeLabel":"object"},"data":{"description":"Data is an arbitrary JSON value that gets sent as the body of the\nwebhook to the endpoints","type":"object","uniqueKey":"data","typeLabel":"object"},"event_type":{"description":"Event Type is used for filtering and debugging e.g invoice.paid","type":"string","uniqueKey":"event_type","typeLabel":"string"},"idempotency_key":{"description":"Specify a key for event deduplication","type":"string","uniqueKey":"idempotency_key","typeLabel":"string"},"owner_id":{"description":"Used for fanout, sends this event to all endpoints with this OwnerID.","type":"string","uniqueKey":"owner_id","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"custom_headers":{},"data":{},"event_type":"\u003cstring>","idempotency_key":"\u003cstring>","owner_id":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Event Details","required":true,"exampleType":"generated"},"responses":{"7647e6ad-d462-4ac0-9e00-e64871a513f7":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"status":{"type":"boolean","uniqueKey":"status","typeLabel":"boolean"},"data":{"type":"object","uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","status":true,"data":{}}}},"exampleType":"generated"}},"description":"Created","exampleType":"generated"},"c146dcab-6a24-4c68-a7a1-8d5b74eeba8f":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"status":{"type":"boolean","uniqueKey":"status","typeLabel":"boolean"},"data":{"type":"object","uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","status":true,"data":{}}}},"exampleType":"generated"}},"description":"Bad Request","exampleType":"generated"},"073b5744-2372-41bd-90f5-137bb6a58ad5":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"status":{"type":"boolean","uniqueKey":"status","typeLabel":"boolean"},"data":{"type":"object","uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","status":true,"data":{}}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"004da6e5-111f-4dee-bc57-3a7554000dad":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"status":{"type":"boolean","uniqueKey":"status","typeLabel":"boolean"},"data":{"type":"object","uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","status":true,"data":{}}}},"exampleType":"generated"}},"description":"Not Found","exampleType":"generated"}},"security":{"8f2252f8-e0e6-4fa2-8600-bc1d7de044d2":{"ApiKeyAuth":{"in":"header","name":"Authorization","type":"apiKey","scopes":[]}}},"servers":{"ea05ed13-6fe8-4fcf-a55a-7dd4fbef101c":{"url":"https://us.getconvoy.cloud/api","description":"US Region"},"88107b80-52be-4d32-be46-16468ea6dbc5":{"url":"https://eu.getconvoy.cloud/api","description":"EU Region"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"in":"header","name":"Authorization","type":"apiKey","scopes":[]},"schema":{"title":"Authorization","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.yml"},"subdomain":"convoy","siteName":"Convoy","title":"Fan out an event - Convoy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T10:00:26.838Z","originalFileLocation":"api-reference/events/fan-out-an-event.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=\"system\"}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=\"This endpoint uses the owner_id to fan out an event to multiple endpoints.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Convoy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_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=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Fan out an event - Convoy\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint uses the owner_id to fan out an event to multiple endpoints.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Convoy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.getconvoy.io/docs/api-reference/events/fan-out-an-event\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://convoy.mintlify.app/_mintlify/api/og/v2?division=Events\u0026amp;title=Fan+out+an+event\u0026amp;description=This+endpoint+uses+the+owner_id+to+fan+out+an+event+to+multiple+endpoints.\u0026amp;theme=c3e2637d3c607fb0b7840509\u0026amp;signature=11a671106bb927061ef3a2ae6efd091e589bd0f28f82c9572b9eac1ed14b7b36\">\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=\"Fan out an event - Convoy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint uses the owner_id to fan out an event to multiple endpoints.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://convoy.mintlify.app/_mintlify/api/og/v2?division=Events\u0026amp;title=Fan+out+an+event\u0026amp;description=This+endpoint+uses+the+owner_id+to+fan+out+an+event+to+multiple+endpoints.\u0026amp;theme=c3e2637d3c607fb0b7840509\u0026amp;signature=11a671106bb927061ef3a2ae6efd091e589bd0f28f82c9572b9eac1ed14b7b36\">\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=\"/docs/mintlify-assets/_mintlify/favicons/convoy/kEzgHUgYWKvNq-_s/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Convoy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2780F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.getconvoy.io/docs/api-reference/events/fan-out-an-event\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/events/fan-out-an-event.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.getconvoy.io/#organization\",\"name\":\"Convoy\",\"url\":\"https://www.getconvoy.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/convoy/ZDnFuM112cm76jYI/logo/light.svg?fit=max\u0026auto=format\u0026n=ZDnFuM112cm76jYI\u0026q=85\u0026s=3d933080cf301678d7fafe5f50d4ec12\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.getconvoy.io/docs#website\",\"name\":\"Convoy\",\"url\":\"https://www.getconvoy.io/docs\",\"publisher\":{\"@id\":\"https://www.getconvoy.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.getconvoy.io/docs/api-reference/events/fan-out-an-event#webpage\",\"url\":\"https://www.getconvoy.io/docs/api-reference/events/fan-out-an-event\",\"name\":\"Fan out an event\",\"description\":\"This endpoint uses the owner_id to fan out an event to multiple endpoints.\",\"dateModified\":\"2026-08-27T10:00:26.838Z\",\"isPartOf\":{\"@id\":\"https://www.getconvoy.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.getconvoy.io/docs/api-reference/events/fan-out-an-event#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.getconvoy.io/docs/api-reference/events/fan-out-an-event#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Events\",\"item\":\"https://www.getconvoy.io/docs/api-reference/events/list-all-events\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Fan out an event\",\"item\":\"https://www.getconvoy.io/docs/api-reference/events/fan-out-an-event\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.getconvoy.io/docs/api-reference/events/fan-out-an-event#apireference\",\"headline\":\"Fan out an event\",\"name\":\"Fan out an event\",\"description\":\"This endpoint uses the owner_id to fan out an event to multiple endpoints.\",\"url\":\"https://www.getconvoy.io/docs/api-reference/events/fan-out-an-event\",\"mainEntityOfPage\":{\"@id\":\"https://www.getconvoy.io/docs/api-reference/events/fan-out-an-event#webpage\"},\"dateModified\":\"2026-08-27T10:00:26.838Z\",\"publisher\":{\"@id\":\"https://www.getconvoy.io/#organization\"},\"isPartOf\":{\"@id\":\"https://www.getconvoy.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Convoy\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Convoy","nav":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://convoy-community.slack.com/join/shared_invite/zt-xiuuoj0m-yPp~ylfYMCV9s038QL0IUQ#/shared-invite/email"},{"anchor":"GitHub","icon":"github","href":"https://github.com/frain-dev/convoy"},{"anchor":"Status","icon":"signal","href":"https://status.getconvoy.io"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/home/quickstart"}]},{"tab":"API Reference","groups":[{"group":"Introduction","pages":[{"title":"Welcome","href":"/api-reference/welcome"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Versioning","href":"/api-reference/versioning"}]},{"group":"Projects","pages":[{"openapi":"get /v1/projects","title":"List all projects","href":"/api-reference/projects/list-all-projects"},{"openapi":"post /v1/projects","title":"Create a project","href":"/api-reference/projects/create-a-project"},{"openapi":"get /v1/projects/{projectID}","title":"Retrieve a project","href":"/api-reference/projects/retrieve-a-project"},{"openapi":"put /v1/projects/{projectID}","title":"Update a project","href":"/api-reference/projects/update-a-project"},{"openapi":"delete /v1/projects/{projectID}","title":"Delete a project","href":"/api-reference/projects/delete-a-project"}]},{"group":"Endpoints","pages":[{"openapi":"get /v1/projects/{projectID}/endpoints","title":"List all endpoints","href":"/api-reference/endpoints/list-all-endpoints"},{"openapi":"post /v1/projects/{projectID}/endpoints","title":"Create an endpoint","href":"/api-reference/endpoints/create-an-endpoint"},{"openapi":"get /v1/projects/{projectID}/endpoints/{endpointID}","title":"Retrieve endpoint","href":"/api-reference/endpoints/retrieve-endpoint"},{"openapi":"put /v1/projects/{projectID}/endpoints/{endpointID}","title":"Update an endpoint","href":"/api-reference/endpoints/update-an-endpoint"},{"openapi":"delete /v1/projects/{projectID}/endpoints/{endpointID}","title":"Delete endpoint","href":"/api-reference/endpoints/delete-endpoint"},{"openapi":"put /v1/projects/{projectID}/endpoints/{endpointID}/expire_secret","title":"Roll endpoint secret","href":"/api-reference/endpoints/roll-endpoint-secret"},{"openapi":"put /v1/projects/{projectID}/endpoints/{endpointID}/pause","title":"Pause endpoint","href":"/api-reference/endpoints/pause-endpoint"},{"openapi":"post /v1/projects/{projectID}/endpoints/{endpointID}/activate","title":"Activate endpoint","href":"/api-reference/endpoints/activate-endpoint"},{"openapi":"post /v1/projects/{projectID}/endpoints/oauth2/test","title":"Test OAuth2 connection","href":"/api-reference/endpoints/test-oauth2-connection"}]},{"group":"Onboard","pages":[{"openapi":"post /v1/projects/{projectID}/onboard","title":"Bulk onboard endpoints with subscriptions","href":"/api-reference/onboard/bulk-onboard"}]},{"group":"Event Deliveries","pages":[{"openapi":"get /v1/projects/{projectID}/eventdeliveries","title":"List all event deliveries","href":"/api-reference/event-deliveries/list-all-event-deliveries"},{"openapi":"post /v1/projects/{projectID}/eventdeliveries/batchretry","title":"Batch retry event delivery","href":"/api-reference/event-deliveries/batch-retry-event-delivery"},{"openapi":"post /v1/projects/{projectID}/eventdeliveries/forceresend","title":"Force retry event delivery","href":"/api-reference/event-deliveries/force-retry-event-delivery"},{"openapi":"get /v1/projects/{projectID}/eventdeliveries/{eventDeliveryID}","title":"Retrieve an event delivery","href":"/api-reference/event-deliveries/retrieve-an-event-delivery"},{"openapi":"put /v1/projects/{projectID}/eventdeliveries/{eventDeliveryID}/resend","title":"Retry event delivery","href":"/api-reference/event-deliveries/retry-event-delivery"}]},{"group":"Event Types","pages":[{"openapi":"post /v1/projects/{projectID}/event-types","title":"Create an event type","href":"/api-reference/event-types/create-an-event-type"},{"openapi":"put /v1/projects/{projectID}/event-types/{eventTypeId}","title":"Updates an event type","href":"/api-reference/event-types/update-an-event-type"},{"openapi":"post /v1/projects/{projectID}/event-types/{eventTypeId}/deprecate","title":"Deprecates an event type","href":"/api-reference/event-types/deprecate-an-event-type"},{"openapi":"post /v1/projects/{projectID}/event-types/import","title":"Import event types from OpenAPI spec","href":"/api-reference/event-types/import-event-types"},{"openapi":"get /v1/projects/{projectID}/event-types","title":"Retrieves a project's event types","href":"/api-reference/event-types/list-event-types"}]},{"group":"Delivery Attempts","pages":[{"openapi":"get /v1/projects/{projectID}/eventdeliveries/{eventDeliveryID}/deliveryattempts","title":"List delivery attempts","href":"/api-reference/delivery-attempts/list-delivery-attempts"},{"openapi":"get /v1/projects/{projectID}/eventdeliveries/{eventDeliveryID}/deliveryattempts/{deliveryAttemptID}","title":"Retrieve a delivery attempt","href":"/api-reference/delivery-attempts/retrieve-a-delivery-attempt"}]},{"group":"Events","pages":[{"openapi":"get /v1/projects/{projectID}/events","title":"List all events","href":"/api-reference/events/list-all-events"},{"openapi":"post /v1/projects/{projectID}/events","title":"Create an event","href":"/api-reference/events/create-an-event"},{"openapi":"post /v1/projects/{projectID}/events/broadcast","title":"Create a broadcast event","href":"/api-reference/events/create-a-broadcast-event"},{"openapi":"post /v1/projects/{projectID}/events/batchreplay","title":"Batch replay events","href":"/api-reference/events/batch-replay-events"},{"openapi":"post /v1/projects/{projectID}/events/dynamic","title":"Dynamic Events","description":"This endpoint does not require creating endpoint and subscriptions ahead of time. Instead, you supply the endpoint and the payload, and Convoy delivers the events","href":"/api-reference/events/dynamic-events"},{"openapi":"post /v1/projects/{projectID}/events/fanout","title":"Fan out an event","href":"/api-reference/events/fan-out-an-event"},{"openapi":"get /v1/projects/{projectID}/events/{eventID}","title":"Retrieve an event","description":"This endpoint retrieves an event","href":"/api-reference/events/retrieve-an-event"},{"openapi":"put /v1/projects/{projectID}/events/{eventID}/replay","title":"Replay event","href":"/api-reference/events/replay-event"}]},{"group":"Meta Events","pages":[{"openapi":"get /v1/projects/{projectID}/meta-events","title":"List all meta events","href":"/api-reference/meta-events/list-all-meta-events"},{"openapi":"get /v1/projects/{projectID}/meta-events/{metaEventID}","title":"Retrieve a meta event","href":"/api-reference/meta-events/retrieve-a-meta-event"},{"openapi":"put /v1/projects/{projectID}/meta-events/{metaEventID}/resend","title":"Retry meta event","href":"/api-reference/meta-events/retry-meta-event"}]},{"group":"Portal Links","pages":[{"openapi":"get /v1/projects/{projectID}/portal-links","title":"List all portal links","href":"/api-reference/portal-links/list-all-portal-links"},{"openapi":"post /v1/projects/{projectID}/portal-links","title":"Create a portal link","href":"/api-reference/portal-links/create-a-portal-link"},{"openapi":"get /v1/projects/{projectID}/portal-links/{portalLinkID}","title":"Retrieve a portal link","href":"/api-reference/portal-links/retrieve-a-portal-link"},{"openapi":"put /v1/projects/{projectID}/portal-links/{portalLinkID}","title":"Update a portal link","href":"/api-reference/portal-links/update-a-portal-link"},{"openapi":"put /v1/projects/{projectID}/portal-links/{portalLinkID}/revoke","title":"Revoke a portal link","href":"/api-reference/portal-links/revoke-a-portal-link"},{"openapi":"get /v1/projects/{projectID}/portal-links/{portalLinkID}/refresh_token","title":"Get a portal link auth token","href":"/api-reference/portal-links/refresh-portal-link-token"}]},{"group":"Sources","pages":[{"openapi":"get /v1/projects/{projectID}/sources","title":"List all sources","href":"/api-reference/sources/list-all-sources"},{"openapi":"post /v1/projects/{projectID}/sources","title":"Create a source","href":"/api-reference/sources/create-a-source"},{"openapi":"get /v1/projects/{projectID}/sources/{sourceID}","title":"Retrieve a source","href":"/api-reference/sources/retrieve-a-source"},{"openapi":"put /v1/projects/{projectID}/sources/{sourceID}","title":"Update a source","href":"/api-reference/sources/update-a-source"},{"openapi":"delete /v1/projects/{projectID}/sources/{sourceID}","title":"Delete a source","href":"/api-reference/sources/delete-a-source"},{"openapi":"post /v1/projects/{projectID}/sources/test_function","title":"Validate source function","href":"/api-reference/sources/validate-source-function"}]},{"group":"Subscriptions","pages":[{"openapi":"get /v1/projects/{projectID}/subscriptions","title":"List all subscriptions","href":"/api-reference/subscriptions/list-all-subscriptions"},{"openapi":"post /v1/projects/{projectID}/subscriptions","title":"Create a subscription","href":"/api-reference/subscriptions/create-a-subscription"},{"openapi":"post /v1/projects/{projectID}/subscriptions/test_filter","title":"Validate subscription filter","href":"/api-reference/subscriptions/validate-subscription-filter"},{"openapi":"post /v1/projects/{projectID}/subscriptions/test_function","title":"Test a subscription function","href":"/api-reference/subscriptions/test-a-subscription-function"},{"openapi":"get /v1/projects/{projectID}/subscriptions/{subscriptionID}","title":"Retrieve a subscription","href":"/api-reference/subscriptions/retrieve-a-subscription"},{"openapi":"put /v1/projects/{projectID}/subscriptions/{subscriptionID}","title":"Update a subscription","href":"/api-reference/subscriptions/update-a-subscription"},{"openapi":"delete /v1/projects/{projectID}/subscriptions/{subscriptionID}","title":"Delete subscription","href":"/api-reference/subscriptions/delete-subscription"}]},{"group":"Subscription Filters","pages":[{"openapi":"post /v1/projects/{projectID}/subscriptions/{subscriptionID}/filters","title":"Create a new filter","href":"/api-reference/filters/create-a-subscription-filter"},{"openapi":"post /v1/projects/{projectID}/subscriptions/{subscriptionID}/filters/bulk","title":"Create multiple subscription filters","href":"/api-reference/filters/bulk-create-subscription-filters"},{"openapi":"put /v1/projects/{projectID}/subscriptions/{subscriptionID}/filters/{filterID}","title":"Update a filter","href":"/api-reference/filters/update-a-subscription-filter"},{"openapi":"put /v1/projects/{projectID}/subscriptions/{subscriptionID}/filters/bulk_update","title":"Update multiple subscription filters","href":"/api-reference/filters/bulk-update-subscription-filters"},{"openapi":"get /v1/projects/{projectID}/subscriptions/{subscriptionID}/filters","title":"List all filters","href":"/api-reference/filters/get-all-subscription-filters"},{"openapi":"get /v1/projects/{projectID}/subscriptions/{subscriptionID}/filters/{filterID}","title":"Get a filter","href":"/api-reference/filters/get-one-subscription-filter"},{"openapi":"delete /v1/projects/{projectID}/subscriptions/{subscriptionID}/filters/{filterID}","title":"Delete a filter","href":"/api-reference/filters/delete-a-subscription-filter"},{"openapi":"post /v1/projects/{projectID}/subscriptions/{subscriptionID}/filters/test/{eventType}","title":"Test a filter","href":"/api-reference/filters/test-a-filter"}]}]},{"tab":"Webhook Guides","pages":[{"title":"Webhook Guides","href":"/webhook-guides/webhook-retries"}]}]},"basePath":"","title":"Fan out an event - Convoy","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CLz2_Z5D.js","utils-7A5jZhOT.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BVWmkKuv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-4SOfrh0F.js","snippetPresets-CMc8KicP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ba9tX7z3.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Be8krXvv.js","shallow-CBC3K1uB.js","getApiPlaygroundDisplay-4tKcUAYo.js","CodeSnippet-C1Xa06ft.js","CodeSnippets-vqiz27A_.js","Page-DeQN5MDd.js","getPastedJson-NUwRfM32.js","icon-DkIVqWh9.js","MethodPill-qmhT7_wz.js","DuplicateIcon-_gWp1vhn.js","createIcon-NA1p_TVA.js","DynamicMarkdown-Bas9A7wq.js","SectionHeading-a1cS-24U.js","axios-vUo_bRtp.js","Markdown-D3ZTwq_a.js","clsx-BcghKhHb.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B66mVNPp.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DmooSyTN.js"]}