functions

Trigger webhook functions

Public endpoint for external services to trigger functions with `trigger.type: webhook`. No authentication required. Optionally verify using `X-Webhook-Secret` header (configure per project or via FUNCTION_WEBHOOK_SECRET). Rate limited to 30 requests per 15 minutes per IP.

POST/api/functions/webhook/{projectId}

Authentication

Public — No Auth Required

Path Parameters

Name	Type	Required	Description
`projectId`	string	Yes	Project ID.

Request Body

Payload sent to the triggered function(s).

json

{}
{}

SDK setup

Create a client instance. No authentication is required for this endpoint.

import { MudbaseClient } from "mudbase";

const client = new MudbaseClient();
import { MudbaseClient } from "mudbase";

const client = new MudbaseClient();

Example request

Call this endpoint using the client from SDK setup. Use View HTTP for a raw cURL example.

const result = await client.functions.triggerWebhook({
  projectId: "proj_6FV4YqriTZxe"
});
const result = await client.functions.triggerWebhook({
  projectId: "proj_6FV4YqriTZxe"
});

Try It Live

Test this endpoint with your own credentials. Your requests will be sent to the live API.

Path Parameters

projectId

Request Body (JSON)

No Request Yet

Send a request to see the full inspector

Responses

200Functions triggered successfully

Successful trigger

json

{
  "success": true,
  "triggered": 2,
  "results": [
    {
      "functionId": "685af8b85d73a104065b6a77",
      "success": true,
      "result": {
        "processed": true
      },
      "executionTime": 45
    },
    {
      "functionId": "685af8b85d73a104065b6a78",
      "success": true,
      "result": {
        "processed": true
      },
      "executionTime": 32
    }
  ]
}
{
  "success": true,
  "triggered": 2,
  "results": [
    {
      "functionId": "685af8b85d73a104065b6a77",
      "success": true,
      "result": {
        "processed": true
      },
      "executionTime": 45
    },
    {
      "functionId": "685af8b85d73a104065b6a78",
      "success": true,
      "result": {
        "processed": true
      },
      "executionTime": 32
    }
  ]
}

No matching functions

json

{
  "success": true,
  "triggered": 0,
  "results": []
}
{
  "success": true,
  "triggered": 0,
  "results": []
}

400Invalid project ID

json

{
  "success": false,
  "error": "program back up"
}
{
  "success": false,
  "error": "program back up"
}

401Invalid webhook secret

json

{
  "success": false,
  "error": "Invalid webhook secret"
}
{
  "success": false,
  "error": "Invalid webhook secret"
}

404Project not found (exact backend message).

429Rate limit exceeded

Errors

Code	Meaning
`400`	Invalid project ID
`401`	Invalid webhook secret
`404`	Project not found (exact backend message).
`429`	Rate limit exceeded

Run in Postman Download OpenAPI

Next steps

Edit this page on GitHub