Guides
API and webhooks
Use the REST API, webhooks, and Zapier to integrate ZenTransfer with your own systems.
Last updated 2026-05-24
On this page
ZenTransfer provides a REST API for retrieving file records and building custom integrations. For instant reactions to new files, webhooks and Zapier are usually simpler than polling.
When to use what¶
| Method | Best for |
|---|---|
| Zapier | No-code automations to 5,000+ apps |
| Webhooks | Your own HTTP endpoint on file arrival |
| REST API | Scheduled sync, custom dashboards, archive scripts |
REST API authentication¶
The API uses OAuth 2.0 client credentials. Find your Client ID and Client Secret in the dashboard.
POST /oauth/token
Content-Type: application/json
{
"client_id": "your_client_id",
"client_secret": "your_client_secret"
}
Include the returned bearer token in the Authorization header on subsequent requests.
Listing files¶
GET /api/files?since=2026-03-01T12:00:00Z&o=0&l=20
Authorization: Bearer <your_bearer_token>
| Parameter | Description |
|---|---|
o | Offset into the result set |
l | Limit (records per page) |
since | ISO datetime — return only files created after this time |
Each record includes id, name, mime_type, size, created, modified, url, and thumbnail_url.
Incremental sync pattern¶
- On first run, fetch all files and store the newest
createdtimestamp. - On each subsequent run, pass that timestamp as
since. - Update the stored timestamp from the latest response.
For instant delivery notifications, prefer Zapier or webhooks over tight polling loops.
Webhooks and Zapier¶
Configure webhooks from your dashboard to POST to your endpoint when a file arrives. Zapier receives the same events and can fan out to Slack, Google Sheets, CMS ingest, and more.
See What is Zapier? (blog) and Zapier integration (features).
Related reading¶
- How to use the ZenTransfer API (blog) — worked examples
- API reference (features) — full endpoint documentation
