API authentication and API keys

All requests to the LinkStacked API must be authenticated using a Bearer token. Tokens are API keys generated from your dashboard.

Generating an API key

1. 1Go to Settings → Security → API keys.
2. 2Click "Generate new key".
3. 3Enter a label to identify what this key will be used for.
4. 4Click "Generate" and copy the key immediately — it's only shown once.

Using your API key

Include your API key in the Authorization header of every request:

curl https://api.linkstacked.com/v1/profile \
  -H "Authorization: Bearer ls_live_YOUR_KEY_HERE"

Key prefixes

• ls_live_ — live environment key; affects real data.
• ls_test_ — sandbox environment key; safe for development and testing.

Authentication errors

If your key is invalid or missing, the API returns HTTP 401 Unauthorized. If your key is valid but doesn't have permission for the requested resource, the API returns HTTP 403 Forbidden.