Webhooks
In this tutorial you will learn how to implement Webhooks so that you can receive events from the Upvest Investment API.
Please make sure you meet the following conditions before attempting this tutorial.
If you're not already familiar with the concept of a "Webhook", please take a moment to read our "API Concepts: Webhooks" documentation.
This tutorial is designed for backend engineers with experience implementing HTTP endpoints for API calls. If you do not have this experience seek the help of someone in your organisation who does before continuing.
Upvest will send events to your Webhook endpoint from specific IP addresses. You must add these IP addresses to your allow list to ensure that you can receive these events. Please see the IP Addresses documentation for more information.
Let's get started!
A Webhook is an HTTPS endpoint hosted in your backend that will handle requests from the Upvest Investment API. In this way you can trigger actions in your own code based on events happening within Upvest's backend.
Many webhooks provide status updates on business processes that are initiated by API calls within the Investment API. The delivery of status via webhooks is not intended to act as a substitute for confirmation of the success or failure of that initial API call.
You should always inspect the returned HTTP status of your API calls to determine whether it was successful or not. Should that call fail, it can be repeated, with an idempotency key.
In order for these HTTP requests to come form Upvest to you, it is necessary to inform the Investment API of the endpoint it should call, and in response to which kind of events. The Investment API provides endpoints for the management of this information. You can create, read, update and delete (CRUD) Webhooks and to test-trigger them to help you integrate with the Investment API.
The following steps will lead you through our recommendations for the implementation of a Webhook handler endpoint, and the use of the Upvest Investment API to create and manage Webhooks.
1 Implementation
1.1 Implement your Webhook handler
Read this sub-task to understand the requirements for a Webhook handler endpoint within your backend.
1.2 Register your Webhook.
In order for your Webhook to be utilised by the Upvest Investment API, we must be informed of its existence. This registration is performed within the API itself.
Read this sub-task to find out how to register and manage your Webhook.
1.3 Test your Webhook.
Once you've implemented and registered your webhook, it's time to test it. This sub-task explains how you can trigger test requests via the Upvest Investment API.
2 Other Webhook Management functions
→ Discover the management functions
Read this sub-task to understand the available Webhook management functionality within the Upvest Investment API.
✔ You're ready to implement Webhooks!
Congratulations! If you've completed all of the tasks above, you're ready to implement Webhooks using the Upvest Investment API.