Use the API and webhooks
Create a personal token, call the supported API, and send paper events to your tools.
Use the public API when you want a script or another service to read and organize your project library. Use a webhook when that service needs to react as papers are added, processed or deleted.
Create a token
Open Account Settings → Access tokens and create a personal access token. Choose read to list projects and papers, write to create or tag papers and manage webhooks, and import to add a paper from an identifier or import a bibliography. Copy the token when it appears; it is not shown again. A token follows your project role and cannot grant access to another person’s project.
The supported routes, inputs and response examples are in the public API explorer. It includes a short tutorial for listing papers and importing a DOI. The OpenAPI contract is the source for client generation. Paper lists use page and page_size. Reuse an Idempotency-Key when retrying a write so it does not create a second record. Requests with a token have a shared per-token limit; a 429 response includes Retry-After.
Subscribe to paper events
Open Account Settings → Webhooks. Enter a public HTTPS endpoint and choose the events it should receive: paper created, parsed, summarized, failed or deleted. After you add it, copy the signing secret from the one-time display and save it in your receiver’s secret store. The receiver should verify each timestamped signature before using the paper data.
Each delivery includes X-Distari-Timestamp and X-Distari-Signature. Verify the sha256= HMAC-SHA256 digest of timestamp + "." + the exact raw request body with your signing secret before parsing the JSON. Reject an old timestamp to limit replay. Open a subscription to inspect recent delivery attempts. A failed delivery retries automatically. If repeated attempts fail, the subscription pauses and you receive a notification; fix the endpoint, resume the subscription and redeliver a failed event if needed. You can pause or delete a subscription from the same screen.
The Zapier and Make connector sources are available in the project repository for private provider testing. They are not listed public apps while live scenarios and provider review remain outstanding.