Webhook Relay Api API

Fast, secure tunnels to your internal networks. [Webhook Relay](https://webhookrelay.com) allows you to expose your localhost

Operations 30

GET /v1/tunnels List All Tunnels
POST /v1/tunnels Create a New Tunnel
GET /v1/tunnels/{tunnelID} Get Tunnel Details
PUT /v1/tunnels/{tunnelID} Update Tunnel Details
DELETE /v1/tunnels/{tunnelID} Delete Tunnel
GET /v1/tokens List All Authentication Tokens
POST /v1/tokens Create a New Authentication Token
PUT /v1/tokens/{tokenID} Update Token Details
DELETE /v1/tokens/{tokenID} Delete Token
GET /v1/buckets List All Buckets
POST /v1/buckets Create a New Bucket
PUT /v1/buckets/{bucketID} Update Bucket
GET /v1/buckets/{bucketID} Get Bucket Details
DELETE /v1/buckets/{bucketID} Delete Bucket
POST /v1/buckets/{bucketID}/inputs Create a New Input
PUT /v1/buckets/{bucketID}/inputs/{inputID} Update Input
DELETE /v1/buckets/{bucketID}/inputs/{inputID} Delete Input
POST /v1/buckets/{bucketID}/outputs Create a New Output
PUT /v1/buckets/{bucketID}/outputs/{outputID} Update Output
DELETE /v1/buckets/{bucketID}/outputs/{outputID} Delete Output
GET /v1/functions List All Functions
POST /v1/functions Create a New Function
PUT /v1/functions/{functionID} Update Function
GET /v1/functions/{functionID} Get Function Details
DELETE /v1/functions/{functionID} Delete Function
GET /v1/logs List logs
POST /v1/logs/{logID}/action Resend log
GET /v1/domains List domain reservations
POST /v1/domains
DELETE /v1/domains/{domainID} Delete a domain reservation

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/webhook-relay:webhook-relay-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

webhook-relay-api-openapi.yml Raw ↑
swagger: '2.0'
info:
  version: '1.0'
  title: "Webhook Relay"
  description: |
    # Introduction
    Fast, secure tunnels to your internal networks. [Webhook Relay](https://webhookrelay.com) allows you to expose your localhost 
    or any other server in private network to the public internet without configuring port forwarding 
    or firewalls. 
    This API is documented in **Swagger format**. Webhook Relay allows to dynamically configure your tunnels and webhook forwarding and request/response 
    transformation using serverless functions.
        
    # Available authentication methods
    Webhook Relay offers three forms of authentication:
      - **Basic Auth** - only available for non-OAuth accounts. Use your username and password.
      - **API Key** - available for all accounts, token pairs can be generated [here](https://my.webhookrelay.com/tokens)
      - **JWT** - mainly used by the [admin dashboard](https://my.webhookrelay.com) with a 'Authorization Bearer: token' 
    
    You can find Swagger and OpenAPI spec files here: [https://github.com/webhookrelay/swagger-webhookrelay](https://github.com/webhookrelay/swagger-webhookrelay).

  termsOfService: "https://webhookrelay.com/tos/"
  contact:
    email: "support@webhookrelay.com"
externalDocs:
  description: Find out more in the official documentation.
  url: 'https://webhookrelay.com/docs'
host: my.webhookrelay.com
basePath: /
schemes:
- "https"
consumes:
- application/json
produces:
- application/json
tags:
  - name: Tokens
    description: Token key & secret pairs are used to authenticate your API calls or for agents to subscribe to webhook forwarding or open tunnels.
  - name: Buckets
    description: Input and output grouping. Bucket allows to have multiple endpoints for the same destination or multiple destinations for fan-out style webhook forwarding.
  - name: Outputs
    description: Outputs are destinations, where your webhooks will be forwarded. Public destinations do not require agents to be running. Internal outputs will not work without an agent.
  - name: Inputs
    description: "Inputs are your public endpoints. Each input serves as an inbox that you can supply to your webhooks producer (ie: Github, Docker, IFTTT)"
  - name: Logs
    description: "Webhook logs hold the status of received and forwarded webhooks. You can use this API group to resend webhooks to one or more destinations"
  - name: Functions
    description: |
      Webhook Relay Functions provide an easy way to extract values from webhooks and transform HTTP 
      requests before passing them to their final destination. Function can be reused by any number 
      of Inputs and/or Outputs. Since user doesn’t have to run a server, this type of function service 
      is also known as FaaS (Function as a Service) or Serverless. 

      Read more about functions here: https://webhookrelay.com/docs/webhooks/functions/manipulating-json.

      Basic function examples can be found here: https://webhookrelay.com/docs/webhooks/functions/modify-request.
  - name: Tunnels
    description: |
      Tunnels allow remote access to internal web services such as local Wordpress, Jekyll or Hexo. Recommended `crypto` options are `flexible` or `tls-pass-through`.  
        
x-tagGroups:
  - name: Authentication
    tags:
      - Tokens
  - name: Webhook Forwarding
    tags:
      - Buckets
      - Outputs
      - Inputs
      - Logs
      - Functions


# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/webhook-relay/refs/heads/main/openapi/_original/webhook-relay-api-openapi.yml