[{"_1":2,"_293":-5,"_294":-5},"loaderData",{"_3":4,"_13":14,"_16":17,"_289":290},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5},"username","routes/_layout.r.$namespace.$reponame",{"_18":19,"_20":-5,"_21":11,"_22":11,"_23":24,"_25":26,"_27":-5,"_28":11,"_29":30,"_80":-5,"_81":82,"_288":11},"canonicalUrl","https://hub.docker.com/r/svix/svix-bridge/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","svix","reponame","svix-bridge","cloudBuildSource","isAutobuildsAvailable","repo",{"_31":32,"_33":34,"_36":37,"_38":39,"_40":11,"_41":42,"_43":44,"_45":46,"_48":26,"_23":24,"_49":50,"_51":-5,"_52":53,"_54":55,"_56":57,"_58":-5,"_59":53,"_60":61,"_62":11,"_63":24,"_64":65,"_70":11,"_71":72,"_77":24,"_78":79},"categories",[],"content_types",[35],"image","date_registered","2023-06-01T17:59:15.706334Z","description","The Svix bridge","is_private","last_updated","2026-02-12T19:09:07.003252Z","last_modified","2025-10-28T15:55:41.516763Z","media_types",[47],"application/vnd.oci.image.index.v1+json","name","pull_count",3842,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n \n \n
Svix - Webhooks as a service
\n \n

\n\n![GitHub tag](https://img.shields.io/github/tag/svix/svix-webhooks.svg)\n[![Build Status](https://github.com/svix/svix-webhooks/workflows/Bridge%20CI/badge.svg)](https://github.com/svix/svix-webhooks/actions)\n[![Bridge Security](https://github.com/svix/svix-webhooks/actions/workflows/bridge-security.yml/badge.svg)](https://github.com/svix/svix-webhooks/actions/workflows/bridge-security.yml)\n[![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)\n[![Join our slack](https://img.shields.io/badge/Slack-join%20the%20community-blue?logo=slack&style=social)](https://www.svix.com/slack/)\n\n# Svix Bridge\n\nBridge is an agent to help integrate webhooks into your existing messaging infrastructure.\n\nBridge is organized in terms of **senders** and **receivers**.\n\n**Senders** are useful when you have a data source (an \"input\") such as a\nmessage queue and want to generate Svix webhooks from those messages.\n\n**Receivers** act as HTTP endpoints which wait for Svix webhooks to arrive, then\npublish the payload on to a specified \"output.\"\n\n**Receivers** also (optionally) perform validation of the webhooks using Svix's signature verification.\n\nBoth **senders** and **receivers** are defined in terms of their input, and optional JavaScript transformation, and their output.\n\n---\n\nTransformations are configured as either a single string of JS source code:\n\n```yaml\ntransformation: |\n function handler(input) {\n return {\n appId: input.key,\n message: {\n eventType: input.event_type,\n payload: input.data\n }\n };\n }\n```\nIn this situation, the input value will be pre-parsed as JSON.\n\nYou can also configure transformations using the verbose form, allowing control of the `format`:\n```yaml\ntransformation:\n format: \"json\"\n src: |\n function handler(input) {\n return {\n appId: input.key,\n message: {\n eventType: input.event_type,\n payload: input.data\n }\n };\n }\n```\nThe `format` field can be set to either `string` (ie. the _raw payload_) or `json` (the default behavior).\n\nFor example, using the string `format` you can parse data out of the input using whatever method you like:\n\n```yaml\ntransformation:\n # Let's say the input is an XML message like:\n # `{\"x\": 123}`\n\n format: \"string\"\n src: |\n function handler(input) {\n let parser = new DOMParser();\n let doc = parser.parseFromString(input, \"text/xml\");\n let msg = doc.firstChild;\n let payload = JSON.parse(msg.getElementsByTagName(\"payload\")[0].textContent)\n\n return {\n appId: msg.attributes.appId,\n message: {\n eventType: msg.attributes.eventType,\n payload,\n }\n };\n }\n```\nTransformations must define a function named `handler` which receives a single argument, the type of which is controlled\nby the configured `format` field.\n\nNote that regardless of the `format`, the return type of `handler` must be an `Object`.\n\n> N.b. at time of writing, `format: string` is unsupported for `senders` and `receivers` configured with\n> a `redis` input or output.\n\n---\n\nCurrently the supported Sender inputs and Receiver outputs are the following\nmessaging systems:\n\n- GCP Pub/Sub\n- RabbitMQ\n- Redis\n- SQS\n\n> Important to note that queues, exchanges, topics, etc should be created and configured independently,\n> prior to using launching Bridge. Bridge will not automatically attempt to create these resources, it will only try\n> (and fail) to read from or publish to the stream/queue in this case.\n\n\n## Installation\n\nDocker images are available on [docker hub](https://registry.hub.docker.com/r/svix/svix-bridge)\n\n```\n$ docker pull svix/svix-bridge\n```\n\nIf you don't want to use docker, see [Building from Source](../README.md#building-from-source).\n\n\n\n# Usage and Configuration\n\nThe CLI itself will look for a config file named `svix-bridge.yaml` or `svix-bridge.json` in the current working\ndirectory.\nAdditionally, Bridge can load its configuration from a different location via `--cfg-file` (or `SVIX_BRIDGE_CFG_FILE`),\nor otherwise the config can be given as a string via `--cfg` (or `SVIX_BRIDGE_CFG`).\n\nExamples:\n```\n# Using the default config file location\n$ svix-bridge\n\n# Specifying an alternate location\n$ svix-bridge --cfg-file path/to/svix-bridge.json\n\n# Config data supplied directly\n$ svix-bridge --cfg '{\"log_format\": \"json\", \"senders\": []}'\n```\n\n## Variable Expansion\n\n`svix-bridge` supports environment variable expansion inside the config file.\n\nUsing \"dollar brace\" notation, e.g. `${MY_VARIABLE}`, a substitution will be made from the environment.\nIf the variable lookup fails, the raw variable text is left in the config as-is.\n\nAs an example, here's a RabbitMQ sender configured with environment variables:\n\n```yaml\nsenders:\n - name: \"send-webhooks-from-${QUEUE_NAME}\"\n input:\n type: \"rabbitmq\"\n uri: \"${MQ_URI}\"\n queue_name: \"${QUEUE_NAME}\"\n output:\n type: \"svix\"\n token: \"${SVIX_TOKEN}\"\n```\n\nEach sender and receiver can optionally specify a `transformation`.\nTransformations should define a function called `handler` that accepts an object and returns an object.\n\nSenders should produce JSON following an expected shape:\n```json\n{\n \"appId\": \"app_XYZ\",\n \"message\": {\n \"eventType\": \"my.event\",\n \"payload\": {\"code\": 123, \"message\": \"something happened...\"}\n }\n}\n```\n\nFor detail on the `message` field, see: \n\nReceivers can accept arbitrary body data but the outputs require a JSON object with a `payload` field representing the\nmessage to publish.\n\n```json\n{\n \"payload\": {\"msg\": \"my cool message, published by svix-bridge!\"}\n}\n```\n\nWhen a transformation is _not configured_, the default behavior is to parse the request body as JSON and set this value\nas the `payload` field before forwarding to the output.\n\nBy configuring a transformation, you should be able to consume a variety of `POST` bodies and\nproduce a valid output, but just remember to make sure the _return value_ has your data attached to the `payload` field.\n\n\nSee the example configs for how to configure each input and output in more detail:\n- [senders](./svix-bridge.example.senders.yaml)\n- [receivers](./svix-bridge.example.receivers.yaml)\n\n# Building from source\n\nYou would need a working Rust compiler in order to build Svix Bridge.\nThe easiest way is to use [rustup](https://rustup.rs/).\n\n```\n# Clone the repository\ngit clone https://github.com/svix/svix-webhooks\n# Change to the source directory\ncd svix-webhooks/bridge/\n# Build\ncargo install --path svix-bridge\n```\n\nSome system dependencies are required for Bridge to build successfully.\nConsult the [Dockerfile](./Dockerfile) for a good reference of what's required at build time.\n\n# Building with Docker\n\n```\n# Clone the repository\ngit clone https://github.com/svix/svix-webhooks\n# Change to the source directory\ncd svix-webhooks/bridge/\n# Build\ndocker build --tag svix-bridge:local .\n```","has_starred","hub_user","immutable_tags_settings",{"_66":11,"_67":68},"enabled","rules",[69],".*","is_automated","permissions",{"_73":74,"_75":11,"_76":11},"read",true,"write","admin","user","storage_size",5800820968,"orgData","recentTags",[83,139,148,157,166,193,202,228,254,263],{"_84":35,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_41":127,"_128":86,"_129":24,"_130":47,"_48":131,"_132":133,"_134":135,"_136":127,"_137":57,"_138":74},"content_type","creator",16785138,"digest","sha256:7c64cf4a7ca545ce1e83fda1bd25d31781dda968cc7114a250eb5fb8f1aeed1c","full_size",67646817,"id",449346159,"images",[95,111,117,123],{"_96":97,"_87":98,"_99":100,"_101":102,"_103":104,"_105":106,"_107":100,"_108":-5,"_109":90,"_54":57,"_110":-5},"architecture","amd64","sha256:4ce0e967009424745bfd903a225d55c5e401a6a89e97fb12e987bf1d40d51d87","features","","last_pulled","2026-02-15T18:43:26.731622778Z","last_pushed","2026-02-12T19:08:56.124411678Z","os","linux","os_features","os_version","size","variant",{"_96":112,"_87":113,"_99":100,"_101":114,"_103":115,"_105":106,"_107":100,"_108":-5,"_109":116,"_54":57,"_110":-5},"arm64","sha256:641ea82c76ffaa2902b584832480478f40351d8cd91b6f11bb24970a11943a20","2026-02-12T19:09:00.12651996Z","2026-02-12T19:08:56.650410387Z",67580661,{"_96":118,"_87":119,"_99":100,"_101":120,"_103":121,"_105":118,"_107":100,"_108":-5,"_109":122,"_54":57,"_110":-5},"unknown","sha256:dfa8bee2f2177135f2dfaa8c21726cbd1297b71a6c4029f2369b0d707c899ec1","2026-02-12T19:09:00.250639137Z","2026-02-12T19:08:57.189475864Z",46517,{"_96":118,"_87":124,"_99":100,"_101":125,"_103":126,"_105":118,"_107":100,"_108":-5,"_109":122,"_54":57,"_110":-5},"sha256:0534b9a6a96cc57757e9c7f82ae0bd21905a01a48ea9eea2d48987c1def2a9e9","2026-02-12T19:09:00.38367083Z","2026-02-12T19:08:57.587958033Z","2026-02-12T19:09:05.743916Z","last_updater","last_updater_username","media_type","v1","repository",20166146,"tag_last_pulled","2026-02-18T15:08:48.178716277Z","tag_last_pushed","tag_status","v2",{"_84":35,"_85":86,"_87":88,"_89":90,"_91":140,"_93":141,"_41":146,"_128":86,"_129":24,"_130":47,"_48":147,"_132":133,"_134":135,"_136":146,"_137":57,"_138":74},1073842738,[142,143,144,145],{"_96":97,"_87":98,"_99":100,"_101":102,"_103":104,"_105":106,"_107":100,"_108":-5,"_109":90,"_54":57,"_110":-5},{"_96":112,"_87":113,"_99":100,"_101":114,"_103":115,"_105":106,"_107":100,"_108":-5,"_109":116,"_54":57,"_110":-5},{"_96":118,"_87":119,"_99":100,"_101":120,"_103":121,"_105":118,"_107":100,"_108":-5,"_109":122,"_54":57,"_110":-5},{"_96":118,"_87":124,"_99":100,"_101":125,"_103":126,"_105":118,"_107":100,"_108":-5,"_109":122,"_54":57,"_110":-5},"2026-02-12T19:09:03.312214Z","v1.85",{"_84":35,"_85":86,"_87":88,"_89":90,"_91":149,"_93":150,"_41":155,"_128":86,"_129":24,"_130":47,"_48":156,"_132":133,"_134":135,"_136":155,"_137":57,"_138":74},1073842709,[151,152,153,154],{"_96":97,"_87":98,"_99":100,"_101":102,"_103":104,"_105":106,"_107":100,"_108":-5,"_109":90,"_54":57,"_110":-5},{"_96":112,"_87":113,"_99":100,"_101":114,"_103":115,"_105":106,"_107":100,"_108":-5,"_109":116,"_54":57,"_110":-5},{"_96":118,"_87":119,"_99":100,"_101":120,"_103":121,"_105":118,"_107":100,"_108":-5,"_109":122,"_54":57,"_110":-5},{"_96":118,"_87":124,"_99":100,"_101":125,"_103":126,"_105":118,"_107":100,"_108":-5,"_109":122,"_54":57,"_110":-5},"2026-02-12T19:09:00.954917Z","v1.85.0",{"_84":35,"_85":86,"_87":88,"_89":90,"_91":158,"_93":159,"_41":164,"_128":86,"_129":24,"_130":47,"_48":165,"_132":133,"_134":135,"_136":164,"_137":57,"_138":74},449346133,[160,161,162,163],{"_96":97,"_87":98,"_99":100,"_101":102,"_103":104,"_105":106,"_107":100,"_108":-5,"_109":90,"_54":57,"_110":-5},{"_96":112,"_87":113,"_99":100,"_101":114,"_103":115,"_105":106,"_107":100,"_108":-5,"_109":116,"_54":57,"_110":-5},{"_96":118,"_87":119,"_99":100,"_101":120,"_103":121,"_105":118,"_107":100,"_108":-5,"_109":122,"_54":57,"_110":-5},{"_96":118,"_87":124,"_99":100,"_101":125,"_103":126,"_105":118,"_107":100,"_108":-5,"_109":122,"_54":57,"_110":-5},"2026-02-12T19:08:58.446819Z","latest",{"_84":35,"_85":86,"_87":167,"_89":168,"_91":169,"_93":170,"_41":190,"_128":86,"_129":24,"_130":47,"_48":191,"_132":133,"_134":192,"_136":190,"_137":57,"_138":74},"sha256:207d1f2b92dfabffc8f7a99e5251dc991e022f09f9bb718b63cee0f4dd77512b",66808080,1039585686,[171,175,181,186],{"_96":97,"_87":172,"_99":100,"_101":173,"_103":174,"_105":106,"_107":100,"_108":-5,"_109":168,"_54":57,"_110":-5},"sha256:58dbf54db24c4fc308a99da961ffc8e2272e1df6e1e0362d101b8bf66bcb63b5","2026-01-27T22:26:25.634002488Z","2025-12-30T04:53:23.0326625Z",{"_96":112,"_87":176,"_99":100,"_101":177,"_103":178,"_105":106,"_107":100,"_108":-5,"_109":179,"_54":180,"_110":-5},"sha256:c7871ec5181ff7567ae5e190b5aaad2287c1c49d56f01fbcb21dc3fe5d7afebf","2025-12-30T04:53:26.372118196Z","2025-12-30T04:53:22.443246724Z",66740045,"inactive",{"_96":118,"_87":182,"_99":100,"_101":183,"_103":184,"_105":118,"_107":100,"_108":-5,"_109":185,"_54":180,"_110":-5},"sha256:9bcbac24050541b84d81bff0a78763035d2d832f9df38355c74aced8123ba8c2","2025-12-30T04:53:26.27411088Z","2025-12-30T04:53:23.575151177Z",46448,{"_96":118,"_87":187,"_99":100,"_101":188,"_103":189,"_105":118,"_107":100,"_108":-5,"_109":185,"_54":180,"_110":-5},"sha256:df3ec792a612507e83b0d77c4c29f9cced9c752ec984d572fd767e37121c3cd0","2025-12-30T04:53:26.473727815Z","2025-12-30T04:53:23.950742783Z","2025-12-30T04:53:29.146219Z","v1.84","2026-02-12T19:08:57.939781266Z",{"_84":35,"_85":86,"_87":167,"_89":168,"_91":194,"_93":195,"_41":200,"_128":86,"_129":24,"_130":47,"_48":201,"_132":133,"_134":192,"_136":200,"_137":57,"_138":74},1039688479,[196,197,198,199],{"_96":97,"_87":172,"_99":100,"_101":173,"_103":174,"_105":106,"_107":100,"_108":-5,"_109":168,"_54":57,"_110":-5},{"_96":112,"_87":176,"_99":100,"_101":177,"_103":178,"_105":106,"_107":100,"_108":-5,"_109":179,"_54":180,"_110":-5},{"_96":118,"_87":182,"_99":100,"_101":183,"_103":184,"_105":118,"_107":100,"_108":-5,"_109":185,"_54":180,"_110":-5},{"_96":118,"_87":187,"_99":100,"_101":188,"_103":189,"_105":118,"_107":100,"_108":-5,"_109":185,"_54":180,"_110":-5},"2025-12-30T04:53:26.922208Z","v1.84.1",{"_84":35,"_85":86,"_87":203,"_89":204,"_91":205,"_93":206,"_41":225,"_128":86,"_129":24,"_130":47,"_48":226,"_132":133,"_134":227,"_136":225,"_137":180,"_138":74},"sha256:0a86cff1aac64e4e3112b9340b142b9e9555ab3938e893007857337c66c8e56b",66809252,1039585676,[207,211,216,221],{"_96":97,"_87":208,"_99":100,"_101":209,"_103":210,"_105":106,"_107":100,"_108":-5,"_109":204,"_54":180,"_110":-5},"sha256:f356f621107ec358700393ae5aa3a5f8d5d05ed0c493b220501d4ca28f716ca3","2025-12-30T00:58:52.130396221Z","2025-12-29T23:58:06.622374444Z",{"_96":112,"_87":212,"_99":100,"_101":213,"_103":214,"_105":106,"_107":100,"_108":-5,"_109":215,"_54":180,"_110":-5},"sha256:d661e01686a16858270440fb5e9a0d3c904ab27ae133a3c57100cda0851e1801","2025-12-30T00:58:51.491736552Z","2025-12-29T23:58:07.205913442Z",66736880,{"_96":118,"_87":217,"_99":100,"_101":218,"_103":219,"_105":118,"_107":100,"_108":-5,"_109":220,"_54":180,"_110":-5},"sha256:135736a616a9b34975b588161a40473ebeb538bd2fc7f519175f5a4c062b8942","2025-12-30T00:58:52.171702574Z","2025-12-29T23:58:07.728353399Z",46605,{"_96":118,"_87":222,"_99":100,"_101":223,"_103":224,"_105":118,"_107":100,"_108":-5,"_109":220,"_54":180,"_110":-5},"sha256:976c3d1658d7fd4d0e75f924ee52562be12628d9114567b2a5c0ea131cc7b3a7","2025-12-30T00:58:51.541266307Z","2025-12-29T23:58:08.093187924Z","2025-12-29T23:58:10.712433Z","v1.84.0","2026-02-11T07:02:40.550045893Z",{"_84":35,"_85":86,"_87":229,"_89":230,"_91":231,"_93":232,"_41":251,"_128":86,"_129":24,"_130":47,"_48":252,"_132":133,"_134":253,"_136":251,"_137":180,"_138":74},"sha256:66bfc7ce1bb98c669736d7eb4823393c5c853c086f9a41e222f4ce0d183420c9",66811251,1031720623,[233,237,242,247],{"_96":97,"_87":234,"_99":100,"_101":235,"_103":236,"_105":106,"_107":100,"_108":-5,"_109":230,"_54":180,"_110":-5},"sha256:ce06e6bc3df791776533222336ed6de19e62148bf1fd35f6e2f90a42258e9e31","2025-12-28T19:50:36.324810358Z","2025-12-15T21:27:43.760240398Z",{"_96":112,"_87":238,"_99":100,"_101":239,"_103":240,"_105":106,"_107":100,"_108":-5,"_109":241,"_54":180,"_110":-5},"sha256:b8baffe3aa471c9993ee849bdf578019eb7da1e640e499df936fdb5ba27e100a","2025-12-23T20:09:29.038712223Z","2025-12-15T21:27:44.714171054Z",66735715,{"_96":118,"_87":243,"_99":100,"_101":244,"_103":245,"_105":118,"_107":100,"_108":-5,"_109":246,"_54":180,"_110":-5},"sha256:98937da0a0dbdc9aa073b32689149c223ee5ed713b85c03e6f671e9d6f900fde","2025-12-15T22:39:43.151925728Z","2025-12-15T21:27:45.1652411Z",46471,{"_96":118,"_87":248,"_99":100,"_101":249,"_103":250,"_105":118,"_107":100,"_108":-5,"_109":246,"_54":180,"_110":-5},"sha256:108c05db5b379d9f538b6eb6ae2fcdb73fd8aa6ecfd59d836ecf6cd1e9f77078","2025-12-15T22:39:43.846453132Z","2025-12-15T21:27:44.237177049Z","2025-12-15T21:27:49.22821Z","v1.83","2025-12-29T23:58:08.394108609Z",{"_84":35,"_85":86,"_87":229,"_89":230,"_91":255,"_93":256,"_41":261,"_128":86,"_129":24,"_130":47,"_48":262,"_132":133,"_134":253,"_136":261,"_137":180,"_138":74},1031720613,[257,258,259,260],{"_96":97,"_87":234,"_99":100,"_101":235,"_103":236,"_105":106,"_107":100,"_108":-5,"_109":230,"_54":180,"_110":-5},{"_96":112,"_87":238,"_99":100,"_101":239,"_103":240,"_105":106,"_107":100,"_108":-5,"_109":241,"_54":180,"_110":-5},{"_96":118,"_87":243,"_99":100,"_101":244,"_103":245,"_105":118,"_107":100,"_108":-5,"_109":246,"_54":180,"_110":-5},{"_96":118,"_87":248,"_99":100,"_101":249,"_103":250,"_105":118,"_107":100,"_108":-5,"_109":246,"_54":180,"_110":-5},"2025-12-15T21:27:47.567302Z","v1.83.0",{"_84":35,"_85":86,"_87":264,"_89":265,"_91":266,"_93":267,"_41":286,"_128":86,"_129":24,"_130":47,"_48":287,"_132":133,"_134":284,"_136":286,"_137":180,"_138":74},"sha256:127b386760824478bf0653b5215ac4c3f824a72106b65ebdfeb44675db03eee5",66806450,1022860159,[268,272,277,282],{"_96":97,"_87":269,"_99":100,"_101":270,"_103":271,"_105":106,"_107":100,"_108":-5,"_109":265,"_54":180,"_110":-5},"sha256:4c4814e81b9551b93ee77fb363ec3d52dc10855d44526cbef989b5d75c0fc37d","2025-12-15T22:39:43.516761122Z","2025-12-02T18:23:40.109764571Z",{"_96":112,"_87":273,"_99":100,"_101":274,"_103":275,"_105":106,"_107":100,"_108":-5,"_109":276,"_54":180,"_110":-5},"sha256:8d87f176359dfa3f3b8eb434782fc7725abd03b07ed193d6609415dc3804b682","2025-12-15T22:39:42.294302408Z","2025-12-02T18:23:41.189743259Z",66740533,{"_96":118,"_87":278,"_99":100,"_101":279,"_103":280,"_105":118,"_107":100,"_108":-5,"_109":281,"_54":180,"_110":-5},"sha256:73c506dfe1285a035edab990a6fd65f7e7471d60b613b3b6b6d428d2152998ef","2025-12-15T22:39:42.963344221Z","2025-12-02T18:23:40.80951408Z",25595,{"_96":118,"_87":283,"_99":100,"_101":284,"_103":285,"_105":118,"_107":100,"_108":-5,"_109":281,"_54":180,"_110":-5},"sha256:b88008bbe75ce98f65f27f751df78805ba7c1af1e1e3b439446d4e75a25e6557","2025-12-15T22:39:44.67503184Z","2025-12-02T18:23:41.793022768Z","2025-12-02T18:23:47.556497Z","v1.82","isPotentialSpam","routes/_layout.r.$namespace.$reponame.tags",{"_291":74,"_292":11},"isRunInDesktopEnabled","canDeleteTags","actionData","errors"]

\n \n \n Svix - Webhooks as a service\n \n

\n \n \n
Svix - Webhooks as a service
\n \n