Processing Webhook

Koyeb

Processing Webhook

Performs an HTTP Call to the server of your choice.

Deploy now
Ready to go in minutes
Ready to go in minutes

Deploy the Processing Webhook integration to process data on your processing stack in no time. Koyeb integrations are preconfigured applications to ingest, process, and store your data.

Infinite combination
Infinite combination

Compose processing workflows with ready to use integrations and your own code if needed. Build your business logic with our SDKs in Golang, Node.js, and Python or using Docker images.

No infrastructure management
No infrastructure management

Koyeb all-in-one platform is backed by a highly available infrastructure. Build advanced operation pipelines for your data with zero server maintenance.

Integration overview

The Processing Webhook integration is an easy way to perform processing or analysis operations on a remote server via a simple HTTP request. It will enable you to easily integrate your own processing logic and behaves as follow:

  • Perform an HTTP POST to the address specified in parameter
  • Store the return of the HTTP request for subsequent processing in the workflow or to be permanently saved to the stack store

The integration provides two ways to send the data in the webhook request:

  • Using a presigned URL in a JSON payload, which allows you to fetch the object and its metadata with a simple HTTP Get
  • Post the data as a Multipart-Encoded File in a multipart/form-data request

Send the data with a presigned URL

This way of sending the data to processed is the default mode and the prefered way as it provides more flexibility. The metadata of the object can easily be retrieved as they will be in the header when you fetch the file.

The payload is a simple JSON:

1
2
3
4
5
6
{
    "object": {
        "key": "MYFILE.jpg",
        "url": "https://presigned.koyeb.com/MYFILE.jpg?AWSAccessKeyId=akeyu&Signature=sig&Expires=1587507312"
    }
}

Send the data in a form encoded fashion

The form encoded option doesn't require you to implement logic to fetch the file as you'll directly receive the payload. The metadata will not be sent.

To simulate the call you'll receive, can you simply use curl:

1
curl -F file=@myfile.txt https://mywebsite.com/koyeb-webhook

Input data

You can use the Webhook integration to process any kind of data. The integration is completely data agnostic and will allow remote processing of images, videos, PDFs, text or any binary data.

Output data

The webhook integration will return the result of the calls to the remote service with one file per call.

About the Koyeb Service Provider

Koyeb

The Platform provides integrated storage and data processing features.

Discover all Koyeb integrations →
20+

20+

Region

50+

50+

Integrations

60

60

Seconds to deploy

Configure Processing Webhook

Additional information to get started with the Processing Webhook integration.

Available settings

  • address — An HTTP URL to post the webhook to.Default value: - Required: Yes
  • mode — How the data should be sent, either with a presigned URL or with form-data.Default value: presigned - Required: No
  • presigned_expiry — Set a value to customize the delay after the presigned URL expires. The value you enter is equal to the duration in seconds. In most cases, the default value is long enough.Default value: 3600 - Required: No
  • secret — A secret with which we will produce a HMAC to secure the message one day.Default value: - Required: No

Ready to get started?

Request your invitation now and deploy your processing stack in minutes.

footer-frame