Webhook Tests

A WebhookTest is an object that can be sent to your Webhook endpoint for connection and response tests.

Create Webhook Test

Endpoint

POST/webhook_tests

Return Object

WebhookTest

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Folder Admin permissions.

Request Parameters

Parameter	Description
url string Required	URL for testing the webhook.
method string	HTTP method(GET or POST).
encoding string	HTTP encoding method. Can be JSON, XML, or RAW (form data).
headers object	Additional request headers.
body object	Additional body parameters.
raw_body string	raw body text
file_as_body boolean	Send the file data as the request body?
file_form_field string	Send the file data as a named parameter in the request POST body
use_dedicated_ips boolean	Use dedicated IPs for sending the webhook?

Example Request

curl https://app.files.com/api/rest/v1/webhook_tests.json \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://www.site.com/...","method":"GET","encoding":"RAW","headers":{"x-test-header":"testvalue"},"body":{"test-param":"testvalue"},"raw_body":"test body","file_as_body":false,"file_form_field":"upload_file_data","use_dedicated_ips":false}' \
  -H 'X-FilesAPI-Key: YOUR_API_KEY'

Example Response

{
  "code": 200,
  "message": "",
  "status": "",
  "data": "example",
  "success": true
}

The WebhookTest Object

Some of the endpoints above return a WebhookTest object. The attributes of this object are listed below.

Attribute	Description
code int64	Status HTTP code
message string	Error message
status string	Status message
data Auto	Additional data
success boolean	The success status of the webhook test

Example WebhookTest Object

{
  "code": 200,
  "message": "",
  "status": "",
  "data": "example",
  "success": true
}