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 email@example.com and let us know you are working on it!
We need an endpoint where we can check if the credentials provided are (still) valid.
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: