Webhook Data Collection

Webhook Overview

What is a Webhook?

Webhooks offer a simple, real-time way to send data from client applications to Ascent360. They are widely used for efficient, event-driven data sharing.

Clients can integrate webhooks to send relevant data (e.g., orders or customer info) directly to Ascent360. Some development effort is required—please contact your Customer Success Manager or the Help Desk before starting.

Example: A POS or PMS system can send purchase data to Ascent360 via webhook. This data can:

• Be added to your database as an integration feed
• Trigger real-time actions, like a custom transaction confirmation email

Ascent360 receives, parses, and stores the data automatically.

How It Works

Ascent360 uses a simple, cloud-hosted application to receive data via HTTP POST at: https://webhook.ascent360.com/V1/Data/{GUID}

Here’s what happens:

1. The client sends a JSON or XML payload to the Ascent360 webhook URL.
2. The URL includes a client-specific GUID for security.
3. Ascent360 stores the raw data securely.
4. The data is parsed into structured fields (using a predefined format).
5. Parsed data is loaded into the Ascent360 database.
6. Optional: Automated actions (e.g., sending an email) can be triggered based on the data.

Webhook Setup Information

Overview

• Ascent360 configures your data source, assigning a Client ID and a GUID (used for security).
• Your unique webhook URL will be: https://webhook.ascent360.com/V1/Data/{GUID}
  Example:https://webhook.ascent360.com/V1/Data/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

• Method: Data must be sent via HTTPS POST to your assigned webhook URL.
• Preferred Format: JSON (XML is supported, but not preferred).
• Implementation: Can be done using server-side or client-side scripts.
• Response: The endpoint returns standard HTTP status codes only (200, 4xx, or 5xx).

How this may look in Postman:

How this may look in Code:

<span class="hljs-keyword">var</span> client = <span class="hljs-keyword">new</span> RestClient(<span class="hljs-string">"https://webhook.ascent360.com/V1/Data/{GUID}"</span>);
<span class="hljs-keyword">var</span> request = <span class="hljs-keyword">new</span> RestRequest(Method.POST);
request.AddHeader(<span class="hljs-string">"cache-control"</span>, <span class="hljs-string">"no-cache"</span>);
request.AddHeader(<span class="hljs-string">"Content-Type"</span>, <span class="hljs-string">"application/json"</span>);
request.AddParameter(<span class="hljs-string">"undefined"</span>, <span class="hljs-string">"{\n\t\"email\":\"test@ascent360.com\"\n}"</span>, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

Ascent360 processes data in real time using one of the following methods:

• Generic JSON Parsing: For simple, well-structured JSON.
• Custom JSON Parsing: For more complex JSON structures.
• Custom Format Parsing: For XML or other formats, based on predefined requirements.

Request Body Parameters

General Notes:

• Only valid JSON will be accepted.
• Even incorrect field names or aliasing won't throw errors if the JSON is valid.
• Values are not case-sensitive.
• Use the exact key names as shown in the Example JSON Request below.

Example JSON HTTP Request Body

If implementing in the web browser, create a JSON string using JavaScript then call the webhook via an XMLHttpRequest. Only the POST method will work. Alternately, this can be accomplished through server-side scripting (i.e. C#, Java, Rust, etc.). 

 var xhttp = new XMLHttpRequest();
 xhttp.open("POST", "  --insert custom webhook URL here--  ");
 xhttp.send(     --insert JSON string here--      );

Do’s & Don’ts

• ✅ Use correct field names and structure.
• ❌ Don’t assume a 200 response means success—data may not be parsed/stored if the format is incorrect.
• ✅ JSON is case-insensitive, but it's best to match key names to the documented format.