body

Set the request body for the most recently added webhook. Used for POST/PUT requests. Writes to the body key of the webhook definition.

body() and params() write to different keys in the webhook specification: body sets the request body, while params sets query/form parameters.

Parameters

data

dict[str, Any]Required

Request body data. Supports ${variable} substitutions.

Returns

DataMap — Self for method chaining. Raises ValueError if no webhook has been added yet.

Example

from signalwire import DataMap, FunctionResult
search = (
    DataMap("search_docs")
    .purpose("Search documentation")
    .parameter("query", "string", "Search query", required=True)
    .webhook(
        "POST",
        "https://api.docs.example.com/search",
        headers={"Authorization": "Bearer TOKEN"}
    )
    .body({"query": "${args.query}", "limit": 3})
    .output(FunctionResult("Found: ${response.results[0].title}"))
)