Documentation

Custom Webhook Integration

Alooma provides a robust REST API as a durable way to capture JSON events from any source and send them to Alooma using a custom webhook from any system that supports webhooks. Check out our blog post for more info on using webhooks!

Set up a custom webhook integration in a few simple steps:

  1. Log in to your Alooma account and click Add new input on the Plumbing page.

  2. Add an "Custom Webhook" input.

  3. Give your input a label (name), and click Next.

  4. Copy the generated URL and register it with the website, or read on for information on how to POST your own JSON events.

  5. Send JSON events using a POST HTTP Request to https://inputs.alooma.com/rest/<YOUR_TOKEN>.

  6. Include the following header for the request's contents: Content-Type: application/json

  7. In the POST body, format your event as a raw JSON object. Any JSON data is acceptable, for example:

    POST https://inputs.alooma.com/rest/<YOUR_TOKEN>
    Content-Type: application/json 
    { 
      "type" : "install", 
      "advertising_id" : "da750d99-8d6f-447a-a0fd-f19b6e98f1a0", 
      "channel" : "advertising_channel", 
      "campaign" : "advertising_campaign", 
      "subscription" : "premium", 
      "timestamp" : "2015-01-01T00:23:11.100Z"
     } 

    A cURL example:

    curl -H "Content-Type: application/json" --data "{ 
    \"type\" : \"install\", 
    \"advertising_id\" : \"da750d99-8d6f-447a-a0fd-f19b6e98f1a0\",
    \"channel\" : \"advertising_channel\", 
    \"campaign\" : \"advertising_campaign\", 
    \"subscription\" : \"premium\", 
    \"timestamp\" : \"2015-01-01T00:23:11.100Z\" 
    }" https://inputs.alooma.com/rest/<YOUR_TOKEN> 

You can also send events via HTTP GET requests by embedding your event in the request query string. For example:

GET https://inputs.alooma.com/rest/<YOUR_TOKEN>?
    type=install&channel=advertising_channel&
    campaign=advertising_campaign...

Note

If you delete a webhook, input data will continue to flow. To stop receiving data, you need to stop the data flow from the source system.

That's it, you're ready to send events to Alooma via a custom webhook. Enjoy!

Search results

    No results found