Skip to content

API Access

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

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: Bearer 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