When integrating with Plecto, we require you to implement an API which we can fetch data from. Additionally, we highly recommend that you implement webhooks that notify us of interesting changes in real-time. You will need an 'api root' per data type you want to send to us - e.g. one for leads and another for opportunities.
Generally speaking, if you implement an API as described below we are happy to add your an integration to your product to Plecto. If you are planning on creating an API as described below, get in touch at firstname.lastname@example.org and let us know you are working on it!
- All datetimes must include timezones.
- All decimals must be either JSON floats or text with no thousand separators and "." as decimal separator.
- We prefer oauth2, but it's not required.
Authentication test API
We need an endpoint where we can check if the credentials provided are (still) valid.
Data fetch API
All endpoints must allow pagination, preferably where the page_size is customisable. We will at max import 1000 items per GET request.
We require you to keep track of updates in your system. Plecto will query your API with modified-date-start and modified-date-end - make sure these use the appropriate fields on your end.
Work in progress
The specs for webhooks are still being drafted. Get in touch if you want to use this feature now!
You will get a unique URL per data source in Plecto where you can send data in the same format as it is returned above. Then you should send updates for the specified url.
Here is an example request: