Verifiers are used to verify webhook events ingested in incoming
webhooks projects. If set, type is required and match the verifier
type object you choose.
{"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/sources/create-a-source","slug":"/api-reference/sources/create-a-source","pageMetadata":{"openapi":"post /v1/projects/{projectID}/sources","title":"Create a source","description":"This endpoint creates a source","href":"/api-reference/sources/create-a-source"},"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 creates a source\"\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":"post /v1/projects/{projectID}/sources","title":"Create a source","description":"This endpoint creates a source","href":"/api-reference/sources/create-a-source"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"parameters":["e2274ff7-9e1f-4ab4-b6e4-4496cfdfc898"],"responses":{"201":"be1b5a3a-bebc-49d5-a432-96a6f51438bf","400":"2dac5d4b-7466-499c-b5ad-6a51fab2daa4","401":"960e8e3c-b223-464b-833d-ce1082e6fab7","404":"6fe5673a-2c1b-43c7-8158-0de8110eb14d"},"security":["2a1d1903-fe9d-493c-8696-89077e4dafaf"],"tags":["Sources"],"description":"This endpoint creates a source","operationId":"CreateSource","requestBody":"d5c23031-977b-4323-8085-44845ea158c0","summary":"Create a source","method":"post","type":"path","servers":["ea05ed13-6fe8-4fcf-a55a-7dd4fbef101c","88107b80-52be-4d32-be46-16468ea6dbc5"],"path":"/v1/projects/{projectID}/sources","baseUrlOptions":["https://us.getconvoy.cloud/api","https://eu.getconvoy.cloud/api"],"title":"Create a source","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e2274ff7-9e1f-4ab4-b6e4-4496cfdfc898":{"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":{"body_function":{"description":"Function is a javascript function used to mutate the payload\nimmediately after ingesting an event","type":"string","uniqueKey":"body_function","typeLabel":"string"},"custom_response":{"type":"object","description":"Custom response is used to define a custom response for incoming\nwebhooks project sources only.","properties":{"body":{"type":"string","uniqueKey":"custom_response.body","typeLabel":"string"},"content_type":{"type":"string","uniqueKey":"custom_response.content_type","typeLabel":"string"}},"uniqueKey":"custom_response","typeLabel":"object"},"event_type_location":{"description":"EventTypeLocation is used to specify where Convoy should read the event type\nfrom an incoming webhook request.","type":"string","uniqueKey":"event_type_location","typeLabel":"string"},"header_function":{"description":"Function is a javascript function used to mutate the headers\nimmediately after ingesting an event","type":"string","uniqueKey":"header_function","typeLabel":"string"},"idempotency_keys":{"description":"IdempotencyKeys are used to specify parts of a webhook request to uniquely\nidentify the event in an incoming webhooks project.","items":{"type":"string","uniqueKey":"idempotency_keys.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"idempotency_keys","typeLabel":"string[]"},"name":{"description":"Source name.","type":"string","uniqueKey":"name","typeLabel":"string"},"provider":{"type":"string","description":"Use this to specify one of our predefined source types.","enum":["github","twitter","shopify"],"x-enum-varnames":["GithubSourceProvider","TwitterSourceProvider","ShopifySourceProvider"],"uniqueKey":"provider","typeLabel":"enum\u003cstring>"},"pub_sub":{"type":"object","description":"PubSub are used to specify message broker sources for outgoing\nwebhooks projects.","properties":{"amqp":{"properties":{"host":{"type":"string","uniqueKey":"pub_sub.amqp.host","typeLabel":"string"},"auth":{"properties":{"password":{"type":"string","uniqueKey":"pub_sub.amqp.auth.password","typeLabel":"string"},"user":{"type":"string","uniqueKey":"pub_sub.amqp.auth.user","typeLabel":"string"}},"type":"object","uniqueKey":"pub_sub.amqp.auth","typeLabel":"object"},"bindExchange":{"properties":{"exchange":{"type":"string","uniqueKey":"pub_sub.amqp.bindExchange.exchange","typeLabel":"string"},"routingKey":{"type":"string","uniqueKey":"pub_sub.amqp.bindExchange.routingKey","typeLabel":"string"}},"type":"object","uniqueKey":"pub_sub.amqp.bindExchange","typeLabel":"object"},"deadLetterExchange":{"type":"string","uniqueKey":"pub_sub.amqp.deadLetterExchange","typeLabel":"string"},"port":{"type":"string","uniqueKey":"pub_sub.amqp.port","typeLabel":"string"},"queue":{"type":"string","uniqueKey":"pub_sub.amqp.queue","typeLabel":"string"},"schema":{"type":"string","uniqueKey":"pub_sub.amqp.schema","typeLabel":"string"},"vhost":{"type":"string","uniqueKey":"pub_sub.amqp.vhost","typeLabel":"string"}},"type":"object","uniqueKey":"pub_sub.amqp","typeLabel":"object"},"google":{"properties":{"project_id":{"type":"string","uniqueKey":"pub_sub.google.project_id","typeLabel":"string"},"service_account":{"items":{"type":"integer","uniqueKey":"pub_sub.google.service_account.items.[INDEX]","typeLabel":"integer"},"type":"array","uniqueKey":"pub_sub.google.service_account","typeLabel":"integer[]"},"subscription_id":{"type":"string","uniqueKey":"pub_sub.google.subscription_id","typeLabel":"string"}},"type":"object","uniqueKey":"pub_sub.google","typeLabel":"object"},"kafka":{"properties":{"auth":{"properties":{"hash":{"type":"string","uniqueKey":"pub_sub.kafka.auth.hash","typeLabel":"string"},"password":{"type":"string","uniqueKey":"pub_sub.kafka.auth.password","typeLabel":"string"},"tls":{"type":"boolean","uniqueKey":"pub_sub.kafka.auth.tls","typeLabel":"boolean"},"type":{"type":"string","uniqueKey":"pub_sub.kafka.auth.type","typeLabel":"string"},"username":{"type":"string","uniqueKey":"pub_sub.kafka.auth.username","typeLabel":"string"}},"type":"object","uniqueKey":"pub_sub.kafka.auth","typeLabel":"object"},"brokers":{"items":{"type":"string","uniqueKey":"pub_sub.kafka.brokers.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"pub_sub.kafka.brokers","typeLabel":"string[]"},"consumer_group_id":{"type":"string","uniqueKey":"pub_sub.kafka.consumer_group_id","typeLabel":"string"},"topic_name":{"type":"string","uniqueKey":"pub_sub.kafka.topic_name","typeLabel":"string"}},"type":"object","uniqueKey":"pub_sub.kafka","typeLabel":"object"},"sqs":{"properties":{"access_key_id":{"type":"string","uniqueKey":"pub_sub.sqs.access_key_id","typeLabel":"string"},"default_region":{"type":"string","uniqueKey":"pub_sub.sqs.default_region","typeLabel":"string"},"queue_name":{"type":"string","uniqueKey":"pub_sub.sqs.queue_name","typeLabel":"string"},"secret_key":{"type":"string","uniqueKey":"pub_sub.sqs.secret_key","typeLabel":"string"}},"type":"object","uniqueKey":"pub_sub.sqs","typeLabel":"object"},"type":{"enum":["sqs","google","kafka","amqp"],"type":"string","x-enum-varnames":["SqsPubSub","GooglePubSub","KafkaPubSub","AmqpPubSub"],"uniqueKey":"pub_sub.type","typeLabel":"enum\u003cstring>"},"workers":{"type":"integer","uniqueKey":"pub_sub.workers","typeLabel":"integer"}},"uniqueKey":"pub_sub","typeLabel":"object"},"type":{"type":"string","description":"Source Type.","enum":["http","rest_api","pub_sub","db_change_stream"],"x-enum-varnames":["HTTPSource","RestApiSource","PubSubSource","DBChangeStream"],"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"verifier":{"type":"object","description":"Verifiers are used to verify webhook events ingested in incoming\nwebhooks projects. If set, type is required and match the verifier\ntype object you choose.","required":["type"],"properties":{"type":{"enum":["noop","hmac","basic_auth","api_key"],"type":"string","x-enum-varnames":["NoopVerifier","HMacVerifier","BasicAuthVerifier","APIKeyVerifier"],"isRequired":true,"uniqueKey":"verifier.type","typeLabel":"enum\u003cstring>"},"api_key":{"properties":{"header_name":{"type":"string","isRequired":true,"uniqueKey":"verifier.api_key.header_name","typeLabel":"string"},"header_value":{"type":"string","isRequired":true,"uniqueKey":"verifier.api_key.header_value","typeLabel":"string"}},"required":["header_name","header_value"],"type":"object","uniqueKey":"verifier.api_key","typeLabel":"object"},"basic_auth":{"properties":{"password":{"type":"string","isRequired":true,"uniqueKey":"verifier.basic_auth.password","typeLabel":"string"},"username":{"type":"string","isRequired":true,"uniqueKey":"verifier.basic_auth.username","typeLabel":"string"}},"required":["password","username"],"type":"object","uniqueKey":"verifier.basic_auth","typeLabel":"object"},"hmac":{"properties":{"encoding":{"enum":["base64","hex"],"type":"string","x-enum-varnames":["Base64Encoding","HexEncoding"],"isRequired":true,"uniqueKey":"verifier.hmac.encoding","typeLabel":"enum\u003cstring>"},"hash":{"type":"string","isRequired":true,"uniqueKey":"verifier.hmac.hash","typeLabel":"string"},"header":{"type":"string","isRequired":true,"uniqueKey":"verifier.hmac.header","typeLabel":"string"},"secret":{"type":"string","isRequired":true,"uniqueKey":"verifier.hmac.secret","typeLabel":"string"}},"required":["encoding","hash","header","secret"],"type":"object","uniqueKey":"verifier.hmac","typeLabel":"object"}},"uniqueKey":"verifier","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"body_function":"\u003cstring>","custom_response":{"body":"\u003cstring>","content_type":"\u003cstring>"},"event_type_location":"\u003cstring>","header_function":"\u003cstring>","idempotency_keys":["\u003cstring>"],"name":"\u003cstring>","pub_sub":{"amqp":{"host":"\u003cstring>","auth":{"password":"\u003cstring>","user":"\u003cstring>"},"bindExchange":{"exchange":"\u003cstring>","routingKey":"\u003cstring>"},"deadLetterExchange":"\u003cstring>","port":"\u003cstring>","queue":"\u003cstring>","schema":"\u003cstring>","vhost":"\u003cstring>"},"google":{"project_id":"\u003cstring>","service_account":[123],"subscription_id":"\u003cstring>"},"kafka":{"auth":{"hash":"\u003cstring>","password":"\u003cstring>","tls":true,"type":"\u003cstring>","username":"\u003cstring>"},"brokers":["\u003cstring>"],"consumer_group_id":"\u003cstring>","topic_name":"\u003cstring>"},"sqs":{"access_key_id":"\u003cstring>","default_region":"\u003cstring>","queue_name":"\u003cstring>","secret_key":"\u003cstring>"},"workers":123}}}},"exampleType":"generated"}},"description":"Source Details","required":true,"exampleType":"generated"},"responses":{"be1b5a3a-bebc-49d5-a432-96a6f51438bf":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"status":{"type":"boolean","uniqueKey":"status","typeLabel":"boolean"},"data":{"properties":{"body_function":{"type":"string","uniqueKey":"data.body_function","typeLabel":"string"},"created_at":{"type":"string","uniqueKey":"data.created_at","typeLabel":"string"},"custom_response":{"properties":{"body":{"type":"string","uniqueKey":"data.custom_response.body","typeLabel":"string"},"content_type":{"type":"string","uniqueKey":"data.custom_response.content_type","typeLabel":"string"}},"type":"object","uniqueKey":"data.custom_response","typeLabel":"object"},"deleted_at":{"type":"string","uniqueKey":"data.deleted_at","typeLabel":"string"},"event_type_location":{"type":"string","uniqueKey":"data.event_type_location","typeLabel":"string"},"forward_headers":{"items":{"type":"string","uniqueKey":"data.forward_headers.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"data.forward_headers","typeLabel":"string[]"},"header_function":{"type":"string","uniqueKey":"data.header_function","typeLabel":"string"},"idempotency_keys":{"items":{"type":"string","uniqueKey":"data.idempotency_keys.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"data.idempotency_keys","typeLabel":"string[]"},"is_disabled":{"type":"boolean","uniqueKey":"data.is_disabled","typeLabel":"boolean"},"mask_id":{"type":"string","uniqueKey":"data.mask_id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"data.name","typeLabel":"string"},"project_id":{"type":"string","uniqueKey":"data.project_id","typeLabel":"string"},"provider":{"enum":["github","twitter","shopify"],"type":"string","x-enum-varnames":["GithubSourceProvider","TwitterSourceProvider","ShopifySourceProvider"],"uniqueKey":"data.provider","typeLabel":"enum\u003cstring>"},"provider_config":{"properties":{"twitter":{"properties":{"crc_verified_at":{"type":"string","uniqueKey":"data.provider_config.twitter.crc_verified_at","typeLabel":"string"}},"type":"object","uniqueKey":"data.provider_config.twitter","typeLabel":"object"}},"type":"object","uniqueKey":"data.provider_config","typeLabel":"object"},"pub_sub":{"properties":{"amqp":{"properties":{"host":{"type":"string","uniqueKey":"data.pub_sub.amqp.host","typeLabel":"string"},"auth":{"properties":{"password":{"type":"string","uniqueKey":"data.pub_sub.amqp.auth.password","typeLabel":"string"},"user":{"type":"string","uniqueKey":"data.pub_sub.amqp.auth.user","typeLabel":"string"}},"type":"object","uniqueKey":"data.pub_sub.amqp.auth","typeLabel":"object"},"bindedExchange":{"type":"string","uniqueKey":"data.pub_sub.amqp.bindedExchange","typeLabel":"string"},"deadLetterExchange":{"type":"string","uniqueKey":"data.pub_sub.amqp.deadLetterExchange","typeLabel":"string"},"port":{"type":"string","uniqueKey":"data.pub_sub.amqp.port","typeLabel":"string"},"queue":{"type":"string","uniqueKey":"data.pub_sub.amqp.queue","typeLabel":"string"},"routingKey":{"type":"string","uniqueKey":"data.pub_sub.amqp.routingKey","typeLabel":"string"},"schema":{"type":"string","uniqueKey":"data.pub_sub.amqp.schema","typeLabel":"string"},"vhost":{"type":"string","uniqueKey":"data.pub_sub.amqp.vhost","typeLabel":"string"}},"type":"object","uniqueKey":"data.pub_sub.amqp","typeLabel":"object"},"google":{"properties":{"project_id":{"type":"string","uniqueKey":"data.pub_sub.google.project_id","typeLabel":"string"},"service_account":{"items":{"type":"integer","uniqueKey":"data.pub_sub.google.service_account.items.[INDEX]","typeLabel":"integer"},"type":"array","uniqueKey":"data.pub_sub.google.service_account","typeLabel":"integer[]"},"subscription_id":{"type":"string","uniqueKey":"data.pub_sub.google.subscription_id","typeLabel":"string"}},"type":"object","uniqueKey":"data.pub_sub.google","typeLabel":"object"},"kafka":{"properties":{"auth":{"properties":{"hash":{"type":"string","uniqueKey":"data.pub_sub.kafka.auth.hash","typeLabel":"string"},"password":{"type":"string","uniqueKey":"data.pub_sub.kafka.auth.password","typeLabel":"string"},"tls":{"type":"boolean","uniqueKey":"data.pub_sub.kafka.auth.tls","typeLabel":"boolean"},"type":{"type":"string","uniqueKey":"data.pub_sub.kafka.auth.type","typeLabel":"string"},"username":{"type":"string","uniqueKey":"data.pub_sub.kafka.auth.username","typeLabel":"string"}},"type":"object","uniqueKey":"data.pub_sub.kafka.auth","typeLabel":"object"},"brokers":{"items":{"type":"string","uniqueKey":"data.pub_sub.kafka.brokers.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"data.pub_sub.kafka.brokers","typeLabel":"string[]"},"consumer_group_id":{"type":"string","uniqueKey":"data.pub_sub.kafka.consumer_group_id","typeLabel":"string"},"topic_name":{"type":"string","uniqueKey":"data.pub_sub.kafka.topic_name","typeLabel":"string"}},"type":"object","uniqueKey":"data.pub_sub.kafka","typeLabel":"object"},"sqs":{"properties":{"access_key_id":{"type":"string","uniqueKey":"data.pub_sub.sqs.access_key_id","typeLabel":"string"},"default_region":{"type":"string","uniqueKey":"data.pub_sub.sqs.default_region","typeLabel":"string"},"endpoint":{"description":"Optional: for LocalStack testing","type":"string","uniqueKey":"data.pub_sub.sqs.endpoint","typeLabel":"string"},"queue_name":{"type":"string","uniqueKey":"data.pub_sub.sqs.queue_name","typeLabel":"string"},"secret_key":{"type":"string","uniqueKey":"data.pub_sub.sqs.secret_key","typeLabel":"string"}},"type":"object","uniqueKey":"data.pub_sub.sqs","typeLabel":"object"},"type":{"enum":["sqs","google","kafka","amqp"],"type":"string","x-enum-varnames":["SqsPubSub","GooglePubSub","KafkaPubSub","AmqpPubSub"],"uniqueKey":"data.pub_sub.type","typeLabel":"enum\u003cstring>"},"workers":{"type":"integer","uniqueKey":"data.pub_sub.workers","typeLabel":"integer"}},"type":"object","uniqueKey":"data.pub_sub","typeLabel":"object"},"type":{"enum":["http","rest_api","pub_sub","db_change_stream"],"type":"string","x-enum-varnames":["HTTPSource","RestApiSource","PubSubSource","DBChangeStream"],"uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"uid":{"type":"string","uniqueKey":"data.uid","typeLabel":"string"},"updated_at":{"type":"string","uniqueKey":"data.updated_at","typeLabel":"string"},"url":{"type":"string","uniqueKey":"data.url","typeLabel":"string"},"verifier":{"properties":{"api_key":{"properties":{"header_name":{"type":"string","uniqueKey":"data.verifier.api_key.header_name","typeLabel":"string"},"header_value":{"type":"string","uniqueKey":"data.verifier.api_key.header_value","typeLabel":"string"}},"type":"object","uniqueKey":"data.verifier.api_key","typeLabel":"object"},"basic_auth":{"properties":{"password":{"type":"string","uniqueKey":"data.verifier.basic_auth.password","typeLabel":"string"},"username":{"type":"string","uniqueKey":"data.verifier.basic_auth.username","typeLabel":"string"}},"type":"object","uniqueKey":"data.verifier.basic_auth","typeLabel":"object"},"hmac":{"properties":{"encoding":{"enum":["base64","hex"],"type":"string","x-enum-varnames":["Base64Encoding","HexEncoding"],"uniqueKey":"data.verifier.hmac.encoding","typeLabel":"enum\u003cstring>"},"hash":{"type":"string","uniqueKey":"data.verifier.hmac.hash","typeLabel":"string"},"header":{"type":"string","uniqueKey":"data.verifier.hmac.header","typeLabel":"string"},"secret":{"type":"string","uniqueKey":"data.verifier.hmac.secret","typeLabel":"string"}},"type":"object","uniqueKey":"data.verifier.hmac","typeLabel":"object"},"type":{"enum":["noop","hmac","basic_auth","api_key"],"type":"string","x-enum-varnames":["NoopVerifier","HMacVerifier","BasicAuthVerifier","APIKeyVerifier"],"uniqueKey":"data.verifier.type","typeLabel":"enum\u003cstring>"}},"type":"object","uniqueKey":"data.verifier","typeLabel":"object"}},"type":"object","uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","status":true,"data":{"body_function":"\u003cstring>","created_at":"\u003cstring>","custom_response":{"body":"\u003cstring>","content_type":"\u003cstring>"},"deleted_at":"\u003cstring>","event_type_location":"\u003cstring>","forward_headers":["\u003cstring>"],"header_function":"\u003cstring>","idempotency_keys":["\u003cstring>"],"is_disabled":true,"mask_id":"\u003cstring>","name":"\u003cstring>","project_id":"\u003cstring>","provider":"github","provider_config":{"twitter":{"crc_verified_at":"\u003cstring>"}},"pub_sub":{"amqp":{"host":"\u003cstring>","auth":{"password":"\u003cstring>","user":"\u003cstring>"},"bindedExchange":"\u003cstring>","deadLetterExchange":"\u003cstring>","port":"\u003cstring>","queue":"\u003cstring>","routingKey":"\u003cstring>","schema":"\u003cstring>","vhost":"\u003cstring>"},"google":{"project_id":"\u003cstring>","service_account":[123],"subscription_id":"\u003cstring>"},"kafka":{"auth":{"hash":"\u003cstring>","password":"\u003cstring>","tls":true,"type":"\u003cstring>","username":"\u003cstring>"},"brokers":["\u003cstring>"],"consumer_group_id":"\u003cstring>","topic_name":"\u003cstring>"},"sqs":{"access_key_id":"\u003cstring>","default_region":"\u003cstring>","endpoint":"\u003cstring>","queue_name":"\u003cstring>","secret_key":"\u003cstring>"},"type":"sqs","workers":123},"type":"http","uid":"\u003cstring>","updated_at":"\u003cstring>","url":"\u003cstring>","verifier":{"api_key":{"header_name":"\u003cstring>","header_value":"\u003cstring>"},"basic_auth":{"password":"\u003cstring>","username":"\u003cstring>"},"hmac":{"encoding":"base64","hash":"\u003cstring>","header":"\u003cstring>","secret":"\u003cstring>"},"type":"noop"}}}}},"exampleType":"generated"}},"description":"Created","exampleType":"generated"},"2dac5d4b-7466-499c-b5ad-6a51fab2daa4":{"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"},"960e8e3c-b223-464b-833d-ce1082e6fab7":{"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"},"6fe5673a-2c1b-43c7-8158-0de8110eb14d":{"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":{"2a1d1903-fe9d-493c-8696-89077e4dafaf":{"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":"Create a source - Convoy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-08-15T14:20:52.041Z","originalFileLocation":"api-reference/sources/create-a-source.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 creates a source\">\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=\"Create a source - Convoy\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint creates a source\">\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/sources/create-a-source\">\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=Sources\u0026amp;title=Create+a+source\u0026amp;description=This+endpoint+creates+a+source\u0026amp;theme=c3e2637d3c607fb0b7840509\u0026amp;signature=a5b098c9382d5fb65ca5fb11528e6a171accaa3514397c2a849b4e993449a054\">\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=\"Create a source - Convoy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint creates a source\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://convoy.mintlify.app/_mintlify/api/og/v2?division=Sources\u0026amp;title=Create+a+source\u0026amp;description=This+endpoint+creates+a+source\u0026amp;theme=c3e2637d3c607fb0b7840509\u0026amp;signature=a5b098c9382d5fb65ca5fb11528e6a171accaa3514397c2a849b4e993449a054\">\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/sources/create-a-source\">\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/sources/create-a-source.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/sources/create-a-source#webpage\",\"url\":\"https://www.getconvoy.io/docs/api-reference/sources/create-a-source\",\"name\":\"Create a source\",\"description\":\"This endpoint creates a source\",\"dateModified\":\"2025-08-15T14:20:52.041Z\",\"isPartOf\":{\"@id\":\"https://www.getconvoy.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.getconvoy.io/docs/api-reference/sources/create-a-source#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.getconvoy.io/docs/api-reference/sources/create-a-source#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sources\",\"item\":\"https://www.getconvoy.io/docs/api-reference/sources/list-all-sources\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a source\",\"item\":\"https://www.getconvoy.io/docs/api-reference/sources/create-a-source\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.getconvoy.io/docs/api-reference/sources/create-a-source#apireference\",\"headline\":\"Create a source\",\"name\":\"Create a source\",\"description\":\"This endpoint creates a source\",\"url\":\"https://www.getconvoy.io/docs/api-reference/sources/create-a-source\",\"mainEntityOfPage\":{\"@id\":\"https://www.getconvoy.io/docs/api-reference/sources/create-a-source#webpage\"},\"dateModified\":\"2025-08-15T14:20:52.041Z\",\"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","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","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","description":"This endpoint fetches multiple 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","description":"This endpoint retrieves a source by its id","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":"Create a source - 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"]}