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
URL is the endpoint's URL prefixed with https. non-https urls are currently
not supported.
Response
Created
The response is of type object.
Was this page helpful?
{"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/dynamic-events","slug":"/api-reference/events/dynamic-events","pageMetadata":{"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"},"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 does not require creating endpoint and subscriptions ahead of time. Instead, you supply the endpoint and the payload, and Convoy delivers the events\"\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/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"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"parameters":["5a9da4c9-9eb2-4cf6-8469-79ecac7bc1f8"],"responses":{"201":"ceb1389d-d4e3-4c01-8090-644751923578","400":"4975b036-3fdd-4d6a-97a8-ee6ce9a91686","401":"f3a84160-a808-4a55-b3cc-ae3e29d8841b","404":"4fff0881-48be-45d5-91b6-f6d795505d3c"},"security":["a19e49dc-2c58-4c04-958c-5b46f28f6458"],"tags":["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","operationId":"CreateDynamicEvent","requestBody":"8771fc1a-4bba-4471-a84f-d71cdd33f3e7","summary":"Dynamic Events","method":"post","type":"path","servers":["ea05ed13-6fe8-4fcf-a55a-7dd4fbef101c","88107b80-52be-4d32-be46-16468ea6dbc5"],"path":"/v1/projects/{projectID}/events/dynamic","baseUrlOptions":["https://us.getconvoy.cloud/api","https://eu.getconvoy.cloud/api"],"title":"Dynamic Events","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5a9da4c9-9eb2-4cf6-8469-79ecac7bc1f8":{"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"},"event_types":{"description":"A list of event types for the subscription filter config","items":{"type":"string","uniqueKey":"event_types.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"event_types","typeLabel":"string[]"},"idempotency_key":{"description":"Specify a key for event deduplication","type":"string","uniqueKey":"idempotency_key","typeLabel":"string"},"secret":{"description":"Endpoint's webhook secret. If not provided, Convoy autogenerates one for the endpoint.","type":"string","uniqueKey":"secret","typeLabel":"string"},"url":{"description":"URL is the endpoint's URL prefixed with https. non-https urls are currently\nnot supported.","type":"string","uniqueKey":"url","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"custom_headers":{},"data":{},"event_type":"\u003cstring>","event_types":["\u003cstring>"],"idempotency_key":"\u003cstring>","secret":"\u003cstring>","url":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Event Details","required":true,"exampleType":"generated"},"responses":{"ceb1389d-d4e3-4c01-8090-644751923578":{"content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"generated"}},"description":"Created","exampleType":"generated"},"4975b036-3fdd-4d6a-97a8-ee6ce9a91686":{"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"},"f3a84160-a808-4a55-b3cc-ae3e29d8841b":{"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"},"4fff0881-48be-45d5-91b6-f6d795505d3c":{"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":{"a19e49dc-2c58-4c04-958c-5b46f28f6458":{"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":"Dynamic Events - Convoy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T10:00:26.836Z","originalFileLocation":"api-reference/events/dynamic-events.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 does not require creating endpoint and subscriptions ahead of time. Instead, you supply the endpoint and the payload, and Convoy delivers the events\">\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=\"Dynamic Events - Convoy\">\u003cmeta data-mint-head property=\"og:description\" content=\"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\">\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/dynamic-events\">\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=Dynamic+Events\u0026amp;description=This+endpoint+does+not+require+creating+endpoint+and+subscriptions+ahead+of+time.+Instead%2C+you+supply+the+endpoint+and+the+payload%2C+and+Convoy+delivers+the+even\u0026amp;theme=c3e2637d3c607fb0b7840509\u0026amp;signature=28b73d761635d3e642dda8d576089dc1354c9ed480fd698cf0af6e26c7f6fabd\">\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=\"Dynamic Events - Convoy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://convoy.mintlify.app/_mintlify/api/og/v2?division=Events\u0026amp;title=Dynamic+Events\u0026amp;description=This+endpoint+does+not+require+creating+endpoint+and+subscriptions+ahead+of+time.+Instead%2C+you+supply+the+endpoint+and+the+payload%2C+and+Convoy+delivers+the+even\u0026amp;theme=c3e2637d3c607fb0b7840509\u0026amp;signature=28b73d761635d3e642dda8d576089dc1354c9ed480fd698cf0af6e26c7f6fabd\">\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/dynamic-events\">\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/dynamic-events.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/dynamic-events#webpage\",\"url\":\"https://www.getconvoy.io/docs/api-reference/events/dynamic-events\",\"name\":\"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\",\"dateModified\":\"2026-08-27T10:00:26.836Z\",\"isPartOf\":{\"@id\":\"https://www.getconvoy.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.getconvoy.io/docs/api-reference/events/dynamic-events#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.getconvoy.io/docs/api-reference/events/dynamic-events#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\":\"Dynamic Events\",\"item\":\"https://www.getconvoy.io/docs/api-reference/events/dynamic-events\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.getconvoy.io/docs/api-reference/events/dynamic-events#apireference\",\"headline\":\"Dynamic Events\",\"name\":\"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\",\"url\":\"https://www.getconvoy.io/docs/api-reference/events/dynamic-events\",\"mainEntityOfPage\":{\"@id\":\"https://www.getconvoy.io/docs/api-reference/events/dynamic-events#webpage\"},\"dateModified\":\"2026-08-27T10:00:26.836Z\",\"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","description":"This endpoint replays multiple events at once.","href":"/api-reference/events/batch-replay-events"},{"openapi":"post /v1/projects/{projectID}/events/dynamic","title":"Dynamic Events","href":"/api-reference/events/dynamic-events"},{"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"},{"openapi":"get /v1/projects/{projectID}/events/{eventID}","title":"Retrieve 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":"Dynamic Events - 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"]}