Webhooks


Since document processing is asyncronous, you will need to know when the document is processed. FileTurn sends an HTTP POST request to your server with the result when processing is finished.

Setup Webhooks in Dashboard

After adding a webhook, you can also send test requests to your webhook from the dashboard.


Example Successful Response
{
  "id": "da6a33f0-ccb5-4891-8918-e8cd40508083",
  "type": "WordToPdf",
  "status": "completed",
  "source_files": [
    "http://www.academichomes.com/downloads/ExampleLeaseAgreement1.doc"
  ],
  "temporary_download_urls": [
    "http://fileturn-dev.s3.amazonaws.com/da116fd8-4d16-4539-8cf1-3775d56affff/ExampleLeaseAgreement1.pdf?AWSAccessKeyId=AKIAJWJK4KZF2KQBC3GA&Expires=1530647088&Signature=sUR%2BTBaXsriN4qx2DTs0bfMPPeM%3D"
  ],
  "processing_time_in_seconds": 14,
  "error_type": null,
  "error_details": null
}
      
Example Failed Response
{
  "id": "d78e8bab-b5bb-4450-8d68-35218f73ed6e",
  "type": "WordToPdf",
  "status": "failed",
  "source_files": [
    "http://www.pdf995.com/samples/pdf.pdf"
  ],
  "temporary_download_urls": [],
  "processing_time_in_seconds": 12,
  "error_type": "processing",
  "error_details": "This file does not seem to be a word document."
}