Webhook deliveries

If you want to customize your JustAsk deliveries, webhooks may be a good fit. They give you the ability to create context-specific workflows beyond what built-in destinations support.

For example, you could use a platform like Zapier to catch JustAsk webhooks and perform different actions based on data values, such as those for CSV-formatted deliveries.

Requirements

To successfully use JustAsk webhook deliveries, your webhook must return an HTTP 200 status response upon delivery. A different status could cause delivery retries or failures.

Creating a webhook delivery

1. Create a webhook URL

Prior to using webhooks as a delivery destination, you’ll need to create a webhook URL for JustAsk to send requests to. For example, using Zapier’s webhook trigger in a Zap will create a webhook URL for you to use.

Note

If access to your webhook server is restricted, you’ll need to whitelist JustAsk’s IP addresses to ensure deliveries are successful.

JustAsk’s IP addresses can be found on any database connection’s page, accessed by navigating to Settings > Connections and clicking a connection. All IP addresses on this page must be included in the allowlist.

2. Configure delivery settings

1. Navigate to a published dashboard.
2. Click File > Deliveries & Alerts. The delivery options will display on the left side of the page.
3. Fill in the following:
   • Delivery — Select Schedule or Alert.
   • Send — Select the content to be delivered.
   • Destination — Select Webhook.
   • Name — Enter a name for the delivery.

If creating an alert, use the Alert tab to define the conditions that must be met to trigger the delivery.

3. Configure the delivery schedule

In this step, you’ll define the cadence for the delivery:

• For schedules, this determines when JustAsk will deliver the specified content to the destination
• For alerts, this tells JustAsk when to check if the current query results meet the conditions required to send the delivery

Schedules can be defined using the visual options or with cron:

Visual schedule builder

Use the UI options (Daily, Weekly, etc.) to select a time period.

By default, schedules are set to send in the local timezone of the delivery creator’s computer. Use the Times are in drop down to change the timezone.

Custom cron schedule (Advanced)

A cron expression is a string that describes the individual details of a schedule:

Order	Unit	Allowed values	Allowed special characters
1	minute	0-59	* , - /
2	hour	0-23	* , - /
3	day of month	1-31	* , - / L W ?
4	month	1-12 or JAN-DEC	* , - /
5	day of week	1-7 or SUN-SAT	* , - / L W ?
6	year	any	* , - /

Using cron, you can create schedules like the following:

At 9:00 AM every day

0 9 ? * * *

At 6:30AM on the last day of the month

30 6 L * ? *

At 8:45 AM every day, Monday through Friday

45 8 ? * MON-FRI *

JustAsk uses Amazon Web Services’ (AWS) syntax for cron expressions. Refer to the AWS documentation for more information. By default, the most frequent you can configure a schedule is hourly.

Tip

If your organization has AI enabled, you can use the AI cron generator to create cron expressions from natural language. Click the sparkle icon next to the cron input field and describe your desired schedule, such as “every weekday at 9am” or “first Monday of each month at noon.”

Tip

Schedule send timezone may be different than query run timezone. For example, if your Database timezone is UTC with no other timezone conversion settings and you set your schedule to send at 12:00 PM PST, the query will execute at 8:00 PM UTC.

4. Select format and filter options

In the Dashboard or Chart tab, you can:

• Select the format of the content, such as PNG, PDF, XLSX, or CSV
• Lightly customize the contents and layout, such as expanding tables to include up to 1,000 rows, hiding filter values, or arranging tiles in a single column.
• Set filter or control values for the delivery. Some formats will have additional customization options. PDF formats, for example, will allow you to specify the orientation and page size for the PDF.

For dashboard deliveries, the default filters and controls will automatically be applied upon creation. Subsequent default filter value updates will not change the filter values set for existing deliveries.

Tip

You can use filters to customize content for different recipients! For example, set a filter to A in a scheduled delivery to recipient A, and in another scheduled delivery to recipient B, set a filter to B.

5. Configure webhook settings

The last step is to configure the webhook settings. Click the Webhook tab and fill in the following:

• URL - Enter the webhook URL you created in step 1 of this guide.
• File Name (Without extension) - Optionally specify a file name for the delivery, leaving out a file extension like .png. Mustache references are supported.

6. Test the delivery

If you want to test the delivery before saving, click the Test Now button in the bottom left corner of the page. This will send the dashboard/chart to the destination using the current settings. For example, using Test Now would send the delivery to all Recipients.

Note

The Test Now button will be unavailable for alerts if the Condition type is Results have changed or Results have stayed the same. A workaround is to use the Send Now option to manually trigger the delivery, which is available once the delivery has been saved.

Save the alert and then click the icon to display the Send Now option. This will initiate a check on the alert condition - if the condition isn’t met, the delivery will show as successful but not send anything.

7. Save the delivery

When finished, click Save to create the delivery.

Request formats

The type of delivery JustAsk sends determines the format the request body will take:

Link-only

JustAsk will send a POST request with a JSON object in the body that contains:

Webhook delivery request body

{  "url": "<dashboard_url>"}

All file formats

JustAsk will send a POST request with the file content directly in the body using streaming delivery:

• Headers:
  • Content-Type - Appropriate MIME type (text/csv, application/json, application/pdf, image/png, etc.)
  • Content-Length - Size of the file in bytes (when available)
  • X-Filename - Original filename for reference
• Body: Raw file content streamed directly

Note

For dashboard deliveries with multiple queries, CSV content will be delivered as a ZIP file with Content-Type: application/zip.