Create a webhook
There are two ways to create webhooks:
- Using our API with the credentials generated on the console.
- Using our console after creating a project.
Using the API
After exposing an endpoint on your server, create a subscription using the POST /v1/subscriptions API. You need to be authenticated with the credentials that Algoan has provided to you.
curl --request POST \
--url https://api.algoan.com/v1/subscriptions \
--header 'Authorization: Bearer access_token' \
--header 'Content-Type: application/json' \
--data '{
"target": "https://your-webhook-endpoint.com",
"secret": "signature_password",
"eventName": "analysis_completed"
}'
Using the console
Alternatively, you can log in to our developer console to create webhooks. After creating your project, navigate into the "Webhooks" section:

Click on the "Add a webhook" button. You will be invited to choose an event and enter a target URL:

To test easily a webhook without opening an endpoint on your server, you can use webhook.site.
Validate the form by clicking on the "Add webhook" button and that's it 🎉 You are now ready to receive events from Algoan.

Next steps
After testing that you receive properly events, we highly recommend you to verify the signature, as described in the next page.