API Reference

Integrate FavForm with your applications using our REST API.

Authentication

FavForm has two types of endpoints:

Authenticated endpoints

Management endpoints (creating, updating, deleting, listing) require an API key. Generate API keys from your developer settings. Requires Business plan.

Public endpoints

Submission endpoints (submit, vote) are public but require an embed token for security. Tokens are issued when loading a form/poll/widget and must be included with submissions. Tokens expire after 30 minutes. The embed SDK handles this automatically.

Base URL

Text

https://favform.com/api

Pagination

List endpoints support pagination with the following query parameters:

Parameter	Default	Description
page	1	Page number
limit	50	Items per page (max 100)

Bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://favform.com/api/forms?page=2&limit=25"

Responses include a pagination object with page, limit, total, and totalPages.

Rate Limits

API requests are rate limited based on your plan:

Plan	Requests/minute
Free	60
Pro	300
Business	1000

Analytics

Analytics data (completion rates, device breakdown, geographic data, conversion funnels) is available through the dashboard but not currently exposed via API. Response metadata includes the raw data needed to build your own analytics if needed.

See the Responses API for available metadata fields.

Endpoints

Forms

View all →

Bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://favform.com/api/forms

GET/api/formsList all forms

POST/api/formsCreate a new form

GET/api/forms/:idGet a form by ID

PUT/api/forms/:idUpdate a form

DELETE/api/forms/:idDelete a form

GET/api/forms/:id/tokenGet embed token

POST/api/forms/:id/submitSubmit a response

Polls

View all →

Bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://favform.com/api/polls

GET/api/pollsList all polls

POST/api/pollsCreate a new poll

GET/api/polls/:idGet a poll by ID

PATCH/api/polls/:idUpdate a poll

DELETE/api/polls/:idDelete a poll

GET/api/polls/:id/tokenGet embed token

POST/api/polls/:id/voteSubmit a vote

GET/api/polls/:id/resultsGet poll results

Widgets

View all →

Bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://favform.com/api/widgets

GET/api/widgetsList all widgets

POST/api/widgetsCreate a new widget

GET/api/widgets/:idGet a widget by ID

PUT/api/widgets/:idUpdate a widget

DELETE/api/widgets/:idDelete a widget

GET/api/widgets/:id/tokenGet embed token

POST/api/widgets/:id/submitSubmit a response

Responses

View all →

Bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://favform.com/api/forms/FORM_ID/responses

GET/api/forms/:id/responsesGet form responses

GET/api/widgets/:id/responsesGet widget responses

DELETE/api/responsesBulk delete responses

← Data Retention Forms API →