Webhook Events

This topic lists the webhook events emitted in the Pleo ecosystem:

  • v1.export.job-created: When a user clicks Export in the Pleo application, an export job is created for exporting the accounting data to the target ERP/accounts application — the v1.export.job-created is generated. If the integration has subscribed to this event, a notification is sent to the configured endpoint.

    JSON
        Event Headers:
        {
            "webhook-id":"msg_p5jXN8AQM9LWM0D4loKWxJek",
            "webhook-timestamp":1614265330,
            "webhook-signature":"v1,g0hM9SsE+OTPJTGt/tmIKtSyZlE3uFJELVlNIOLJ1OE="
        }
        Event Body:
        {
            "data": {
            		"key": "value",
            .....,
        		},
            "eventType": "v1.export-job.created",
            "eventId": "13d8550d-dd22-46e9-ae18-c171846ba373"
        }
    ```
    
  • v1.vendor.created: When any vendor is created in Pleo (the record is not yet existing in the ERP/accounting system), a webhook event v1.vendor.created is triggered. If the integration has subscribed to this event, a notification is sent to the configured endpoint.
    JSON
    	"Event Headers":  
    		{  
        "webhook-id":"msg_p5jXN8AQM9LWM0D4loKWxJek",  
        "webhook-timestamp":1614265330,  
        "webhook-signature":"v1,g0hM9SsE+OTPJTGt/tmIKtSyZlE3uFJELVlNIOLJ1OE="  
    		}  
    		"Event Body":  
    			{  
        	"data": {  
            "id": "c27ed4d6-3d3d-458e-8f3f-735fdf32a3bc",  
            "companyId": "00000000-0000-0000-0000-000000000000",  
            "name": "Pleo Technologies GmbH",  
            "country": "DE",  
            "registrationNumber": "",  
            "taxRegistrationNumber": "DE36538686",  
            "code": null,  
            "state": "DRAFT",  
            "defaultCurrency": "EUR",  
            "createdBy": "22aff90a-a53d-4f0c-851f-dd4cc85ac947",  
            "createdAt": "2025-02-21T10:05:43.530450712Z",  
            "updatedAt": "2025-02-21T10:05:43.530450712Z",  
            "deletedAt": null,  
        	},  
        "eventType": "v1.vendor.created",  
        "eventId": "13d8550d-dd22-46e9-ae18-c171846ba373"  
    	}