Introduction
Getting started with the Clipform REST API.
The Clipform API lets you create and manage video forms programmatically. You can create forms, add nodes, upload media, and more - all from your own code or tools like the MCP server.
The API is available on every plan, including the free tier - no sales call required. Sign up, then create your own key in the dashboard (see API Keys).
Base URL
All API requests use the following base URL:
https://api.clipform.io/v1Authentication
Every request must include an API key as a Bearer token in the Authorization header:
curl https://api.clipform.io/v1/me \
-H "Authorization: Bearer cf_your_key_here"See API Keys to create a key and manage access.
What you can do
| Area | Description |
|---|---|
| Forms | Create, list, update, and delete forms including theme colours |
| Nodes | Add nodes (Choice, Open-Ended, Contact, etc.) to forms |
| Node Media | Upload videos or images to nodes |
| Tags | Organise forms with tags |
| Analytics | Read funnel analytics, submissions, and results |
| Authentication | Verify your API key and check workspace info |
Rate limits
The API enforces rate limits based on your plan. Every response carries the IETF-draft RateLimit header fields so you can self-throttle:
| Header | Meaning |
|---|---|
RateLimit-Limit | Request quota for the current window |
RateLimit-Remaining | Requests remaining in the window |
RateLimit-Reset | Seconds until the window resets |
If you exceed the limit, requests return 429 Too Many Requests with a Retry-After header (seconds to wait). Back off for that long, then retry.
Versioning
The API is versioned in the URL path (/v1), and deprecations are signalled with Deprecation and Sunset headers. See Versioning for the full policy.