Skip to content

API Access

Basin provides a REST API for programmatic access to your forms and submissions.

Plan availability

API access is included on Growth, Pro, and Agency plans.

API Documentation

For complete API documentation, endpoints, and an interactive explorer:

→ Basin API Docs (Swagger)

Finding Your API Keys

Basin has two types of API keys:

Account API Key

Provides access to all forms and projects in your account.

Location: Account Settings → API Settings Direct link: usebasin.com/app/api_settings

Form API Key

Provides access to a single form only. Used primarily for Zapier and similar integrations.

Location: Form Dashboard → Integrations → API (or Zapier)

Security Best Practices

  • Never expose API keys in frontend code - Use server-side code only
  • Use environment variables - Don't hardcode keys in source code
  • Prefer Form API Keys when you only need access to one form
  • Regenerate if compromised - You can regenerate your Account API Key in API Settings

Troubleshooting

Error Solution
401 Unauthorized Check your API key is correct and use Authorization: Token YOUR_KEY header
403 Forbidden Verify your plan includes API access; Form API keys can't access other forms
404 Not Found Check the endpoint URL and resource ID