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