API Reference

Creating validations in Plutto is easy, but the time they take to complete is variable. It could go from less than a minute to a couple of them. That's why we implemented webhooks to let you know when validations are ready to be reviewed.

📘

Webhooks are set in each validation

You can choose in each validation if you want to be notified when it's completed. There's no global setting so you can have total control.

🌐 Available Webhooks

  • 🔄 Information Request Webhooks
    Focused on the Information Request object, this section lists all available events that provide updates and changes related to information request processes. These events help you track assignment statuses, information request changes, and document uploads in real-time.

  • ✅ Validation Webhooks
    Centered around the Validation object, this section outlines events that notify you of updates or changes in validation workflows, ensuring you stay informed about the status and progress of validations.

How to set up webhooks

The only thing you need to do is to add the field webhook_url to the validation object when creating a validation with our API. If you want to setup a webhook for a validation created in the dashboard let us know.

{
    "entity_validation": {
        "tin": "77447361-0",
        "country": "CL",
        "contact_email": "[email protected]",
        "webhook_url": "https://yoursite.com/some-webhook-path" //only https urls allowed
    }
}

How to validate our webhooks?

In order to validate that the data is really coming from our end, you can check that the Bearer token in the Authorization header is in fact the one that you set.

Thus, in a webhook request, you might find something as the following example:

POST /webhook_url HTTP/1.1
Host: plutto_backend.com
Content-Type: application/json
Accept: application/json
Authorization: Bearer sk_ef9f347e8e2ea65ebf074d2fd18187fd87ff52fc28954e8d
Content-Length: 81

{
  "firstName": "Jane",
  "lastName": "Doe",
  "email": "[email protected]"
}

In this case, the Authorization header is Authorization: Bearer sk_ef9f347e8e2ea65ebf074d2fd18187fd87ff52fc28954e8d.

📘

Setting Your Webhooks Bearer Tokens

In case you haven't already set your bearer token, please contact us