webhooks for workflow calls
# support
y
like i can specify server url in assistants for calls , how can i provide webhook url for workflow calls ? i do no see any option for workflow to provide webhook
v
Currently, Vapi does not support setting a webhook/server URL directly at the workflow level. You can only specify server URLs for assistants, phone numbers, or function calls—not for workflows themselves. If you need to trigger an external webhook from a workflow, use an "API Request" node within your workflow to send data to your endpoint as part of the flow. There is no option to receive workflow-wide webhook events at this time. Sources: - [Setting Server URLs](https://docs.vapi.ai/server-url/setting-server-urls) - [Workflows Quickstart](https://docs.vapi.ai/workflows/quickstart)
y
then how can i get logs of workflow calls?
k
Vapi doesn’t support setting webhook URLs directly in workflows instead, you must configure a global Server URL in the dashboard under Settings → Server URLs, which will receive all assistant and workflow-related webhook events.. https://docs.vapi.ai/server-url
y
but it does not allow me to specify backoff plan for retries , i can specify server url while creating phone number and can provide backoff plan there so i can do use phone number server url setting to receive webhook for all cases along with retry mechanism
c
Hey, sorry to hear about the issue with your account. Could you please record a loom video showing the error or behavior you're experiencing? It would really help us understand the problem better. Also, please share your account email address so we can assist you further.
y
hi , i was asking that there is not any option on dashboard anywhere , i have to partially cerate something from apis using sdk providing backoff plan and then update other things from dashboard after cerating from apis , also node sdk does not support features on dashboard in workflows.
c
Yeah, we are aware about it and it is on the roadmap to fix it.
p
@User @Vapi @Vapi Incident @Vapi Support Bot Hi Vapi Team, I noticed that currently Vapi does not allow setting a webhook/server URL directly at the workflow level—you can only specify server URLs for assistants, phone numbers, or function calls. I have a couple of questions and requests: Timeline for Workflow Webhooks: Are there plans to support workflow-level webhooks in a future update? If so, could you share an expected timeline? Tutorial/Video Request: Could you create a detailed tutorial or video showing how to trigger external webhooks from workflows using the "API Request" node? It would help users like me understand the best practices and implementation steps clearly.
v
To trigger an external webhook from a workflow, add an API Request node and configure it like this:
Copy code
json
{
  "url": "https://your-webhook-endpoint.com/receive",
  "method": "POST",
  "headers": { "Content-Type": "application/json" },
  "body": {
    "workflow_id": "{{workflow_id}}",
    "event": "step_completed",
    "custom_data": "{{some_variable}}"
  }
}
This will send a POST request to your webhook as part of the workflow execution. You can map any workflow variables into the payload as needed. For more details, see the [API Request node documentation](https://docs.vapi.ai/workflows/nodes/api-request). Source: - [API Request Node Documentation](https://docs.vapi.ai/workflows/nodes/api-request)
v
You can trigger an external webhook from a workflow by adding an API Request node and configuring it like this:
Copy code
json
{
  "url": "https://your-webhook-endpoint.com/receive",
  "method": "POST",
  "headers": { "Content-Type": "application/json" },
  "body": {
    "workflow_id": "{{workflow_id}}",
    "event": "step_completed",
    "custom_data": "{{some_variable}}"
  }
}
This will send a POST request to your webhook as part of the workflow execution. You can map any workflow variables into the payload as needed. Reference: [API Request Node Example](https://docs.vapi.ai/workflows/nodes/api-request) (if the link is down, use the above example as a template). Source: - [API Request Node Documentation](https://docs.vapi.ai/workflows/nodes/api-request)
p
@User page not found which the bot has given Are there plans to support workflow-level webhooks in a future update? If so, when might this be available? Could you create a detailed tutorial or video showing how to trigger external webhooks from workflows using the "API Request" node? It would be very helpful for users to see a complete step-by-step example.
@Vapi @Vapi let me know the above question answer @User
hey @Vapi Incident @Vapi the link which you have given to follow for webhook to hit document is not their what to do and the webhook is not getting hit in workflow i have used the api note passing the request body and response body to too and still not able to get @Vapi Support Bot @User https://cdn.discordapp.com/attachments/1381736852201144361/1427877423147647170/image.png?ex=68f075fa&is=68ef247a&hm=8c4347116d07f68b2ae91c7ff26835febc4adf0f5df865fa86adbf7723d4ef9c&
v
If your webhook is not being hit from a workflow, double-check your API Request node configuration and ensure your endpoint is publicly accessible. Here’s a minimal example for your node:
Copy code
json
{
  "url": "https://your-webhook-endpoint.com/receive",
  "method": "POST",
  "headers": { "Content-Type": "application/json" },
  "body": {
    "workflow_id": "{{workflow_id}}",
    "event": "step_completed"
  }
}
Make sure your server is running, the URL is correct, and you can receive POST requests from external sources. Test your endpoint with a tool like
curl
to confirm it works outside of Vapi as well.
For more details, see the [API Request node documentation](https://docs.vapi.ai/workflows/nodes/api-request). Source: - [API Request Node Documentation](https://docs.vapi.ai/workflows/nodes/api-request)
p
@Vapi Support Bot tell me what should be there in api node and give me proper example and there is no json format to paste in their there a feilds so tell me according to that ?
v
To help you better: Could you specify which field in the API Request node you are unsure about (e.g., URL, method, headers, body, or output mapping), or describe any error message you see when trying to save or run the node? This will help me provide a step-by-step example tailored to your exact issue. Source: - [API Request Node Documentation](https://docs.vapi.ai/workflows/nodes/api-request)
To configure the API Request node in your workflow UI, fill out the fields as follows: - URL:
https://your-webhook-endpoint.com/receive
- Method:
POST
- Headers: - Key:
Content-Type
- Value:
application/json
- Body: - Key:
workflow_id
| Value:
{{workflow_id}}
- Key:
event
| Value:
step_completed
- (Add more keys/values as needed for your payload) Make sure your webhook endpoint is publicly accessible and can receive POST requests. Test with
curl
if needed to confirm connectivity.
Source: - [API Request Node Documentation](https://docs.vapi.ai/workflows/nodes/api-request)
p
give me information or steup for every feilds how to setup in the worflow the api note to hit the webbhook api @Vapi @Vapi Incident @Vapi Support Bot
v
To set up the API Request node in your workflow to hit a webhook, fill out the fields as follows: - URL:
https://your-webhook-endpoint.com/receive
- Method:
POST
- Headers: - Key:
Content-Type
- Value:
application/json
- Body: - Key:
workflow_id
| Value:
{{workflow_id}}
- Key:
event
| Value:
step_completed
- (Add more keys/values as needed for your payload) Each field is entered separately in the node UI. Make sure your webhook endpoint is publicly accessible and test it with a tool like
curl
to confirm it works.
For more details, see the [API Request node documentation](https://docs.vapi.ai/workflows/nodes/api-request). Source: - [API Request Node Documentation](https://docs.vapi.ai/workflows/nodes/api-request)
2 Views