All docs
1 min read Last updated:

Authentication

The REST API authenticates with bearer tokens. The MCP server uses the same tokens. Mint, manage, and revoke from the API tokens page.

Header

text
Authorization: Bearer your-api-token

Mint a token

API tokens page with abilities checklist

  1. Go to API tokens.
  2. Click Create token, name it, pick the abilities the holder should have.
  3. Copy the value immediately - it's shown once.

If you lose it, revoke and mint a new one.

Test it

bash
curl -H "Authorization: Bearer your-api-token" \
  https://formspring.io/api/v1/me

You'll see your user, current team, plan, and the abilities of this token.

Plan gating

The REST API and MCP server are available on every plan, including Free. Free-plan tokens can read and write forms, submissions, links, and automations. Plan-gated resources (surveys, funnels, AI insights, custom retention) answer 402 Payment Required until the team upgrades - see Plans for the full matrix.

Revoke

Open API tokens → click the trash icon next to the token. Active sessions die on the next call.

What's next