How to Use the Webhook Agent in Victoria AI

The Webhook Agent lets you connect your workflows to any external API using HTTP requests. You can send or retrieve data dynamically using information from earlier steps in your automation.

This guide explains how to configure the Webhook Agent and how to use dynamic values pulled from your workflow state to populate your requests.

Webhook Agent Fields

Here’s a breakdown of each field you’ll configure:

Prompt

Use this to describe what the agent should do. This prompt helps guide the AI’s reasoning and ensures it maps the right values into your request body.

URL

Enter the full URL of the endpoint you want to call. For example:
https://api.example.com/customers

Method

Select the HTTP method to use for the request. Supported methods include:

• GET
• POST
• PUT
• DELETE

Access Token (Optional)

If the endpoint requires authentication, you can paste your access token here. It will be automatically added to the request headers as a bearer token:

makefile

CopyEdit

Authorization: Bearer <your-token>


Request Body

This is where you define the JSON structure to be sent with your request. You’ll define:

• Keys: These should match exactly what the API expects.
• Values: These can either be hardcoded values or natural language instructions telling the agent how to populate them dynamically using previous agent outputs.

How to Write the Request Body

The request body should follow valid JSON formatting. Each key represents a field the API expects. Each value can either be:

• A static value (e.g., "status": "active")
• An instruction for the agent to follow (e.g., "email": "Enter the customer’s email address from the previous step")

This makes it possible for the agent to fill in request data using context from earlier in the workflow.

Example Request Body

{
 "email": "Enter the customer’s email address from the previous step",
 "name": "Enter the full name of the customer",
 "status": "active"
}


In this example:

• email and name will be filled in by the agent based on earlier steps.
• status will be sent exactly as written: "active".

⚠️ Make sure the keys ("email", "name", "status", etc.) match what your target API expects. The agent will only update the values, not the keys.

Best Practices

• ✅ Match key names exactly as required by the API you're working with.
• ✅ Write clear, specific instructions for each value you want the agent to fill in.
• ✅ Use static values where applicable — not everything needs to be dynamic.
• ✅ Secure your access tokens — only use them if needed, and avoid sharing them in public workflows.

Example Use Cases

Here are a few ways you can use the Webhook Agent:

• Send user form data to your CRM
• Create new contacts in a third-party tool
• Trigger events in your billing system
• Post updates to an external webhook or automation service

Wrapping Up

The Webhook Agent is one of the most flexible tools in your Victoria AI toolkit. With the ability to dynamically populate request bodies and connect to any external system, it opens the door to powerful integrations without writing any code.

By combining natural language prompts with structured data, you can build smart, context-aware workflows that connect across your entire stack.

Let us know if you’d like help with your first integration — or check out our templates to get started faster.