Surface
Help CenterContact UsDashboard
HomePlatformFor DevelopersGuidesForm EmbeddingMCP
API Reference

API Keys

Create and manage API keys for the Surface API

Every request to the Surface API needs an API key. A key is scoped to one environment and can reach every resource in that environment.

Creating an API Key

Get API key from Surface
  1. Log in to your Surface account.
  2. Go to Settings > API Keys.
  3. Click on + Add API Key.
  4. Give your key a name and click Create.
  5. Copy and note down the API key immediately, as it won't be shown again.

A key is shown once, when you create it. Store it somewhere secure. If you lose it, create a new one.

Using Your API Key

Include your API key in the x-api-key header for all API requests:

curl -X GET 'https://forms.withsurface.com/api/v1/responses' \
  -H 'x-api-key: your-api-key-here'

Ready to Get Started?

See it on your own site, or open the app and build the first form.

Book a walkthroughOpen the dashboard

Need Help?

Setup problems, blocked domains and CRM push failures live in the Help Center.

Help Center

Feature Requests?

Tell us what is missing. We would rather hear it than guess.

Talk to us

Step 3.3: Submit Form

Submit Multi-Step HTML Form

Generate Form

Create a form from a source template with the API

On this page

Creating an API KeyUsing Your API Key