Introduction

Welcome to the MakeForm API — build, manage, and automate forms programmatically.

Base URL

The MakeForm API is built on REST principles. All requests must use HTTPS.

https://api.makeform.ai

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer mk_xxxxxxxxxxxxx

Create API keys from your MakeForm dashboard under Settings → API Keys.

Successful responses return the resource directly:

{
  "id": "abc123",
  "name": "My Form"
}

List endpoints return paginated results:

{
  "data": [...],
  "total": 42,
  "page": 1,
  "limit": 10,
  "has_more": true
}

Errors follow a consistent format:

{
  "error": "Form not found",
  "type": "not_found"
}

Code	Description
`200`	Success
`201`	Created
`400`	Bad request — malformed or invalid parameters
`401`	Unauthorized — missing or invalid API key
`403`	Forbidden — insufficient permissions
`404`	Not found — resource doesn't exist
`422`	Validation error — check the error message
`429`	Rate limited — too many requests
`500`	Server error — something went wrong on our end

API requests are limited to 100 requests per minute per API key. When rate limited, you'll receive a 429 response.

Tip: Use webhooks instead of polling for new submissions — it's more efficient and won't count against your rate limit.