Last updated March 27, 2019

We have a whole section on the API block and the different kinds of functions you can perform with it. To access this section look for "API & Integration Tutorials" in the Voiceflow University menu.

What You'll Learn 🧠

  • How to use the API block to send requests to outside services
  • How to use the Endpoint Tool to test whether your requests are working successfully.
  • A general walkthrough of the different tools within the API block
  • Insight into how responses work

Video Tutorial:


API blocks let us access code bases and integrations outside of Voiceflow easily and with little work. The API Block will retrieve data that is sent from outside sources and store them within your project so they can be used throughout your canvas. Similarly, this block can also send data created in Voiceflow to these external databases.

There are several important portions to the above panel. Let's start with the drop down menu.

There are 5 different types of calls that we can make. Here is a short explanation of each:

GET: Retrieve some data from the external codebase
POST: Create some data to the external codebase
PUT: Update some data to the external codebase
DELETE: Delete data at the external codebase
Apply partial modifications to data at an external codebase

Success and Failure

There are several status codes that API's can return us when we try to call them.

  • 1xx (Informational): The request was received, continuing process
  • 2xx (Successful): The request was successfully received, understood, and accepted. This is what we want every time.
  • 3xx (Redirection): Further action needs to be taken in order to complete the request
  • 4xx (Client Error): The request contains bad syntax or cannot be fulfilled
  • 5xx (Server Error): The server failed to fulfill an apparently valid request

We don't need to worry about the majority of these codes. We just need to know that successful codes (2xx) will let us move on in our diagrams, and all others will be handled by the "fail" socket and we should specify an error message in case this happens, as demonstrated below:

To find out how we can actually use these requests in detail, head over to our tutorials on GET, POST, PUT and DELETE requests

To see it in action, checkout our tutorials on:

Did this answer your question?