LinkStacked

Getting started

This page walks you from zero to a working GraphQL call. By the end you'll have a session token, a query in your terminal, and a sense of where the rest of the API lives.

1. Create a Linkstacked account

You'll need an account to mint tokens. Sign up (it's free) and land on the dashboard. Everything below works on the FREE plan.

2. Issue a session token

Linkstacked issues bearer tokens through OAuth flows for production integrations, but for local exploration the simplest path is to copy the token your dashboard already uses:

    1. Open the dashboard in your browser.
    2. Open DevTools → Application → Cookies → ls_session.
    3. Copy the value. That's your bearer token for the rest of this guide.

Don't ship session tokens

The cookie token is fine for trying things out from your terminal. For real integrations use the OAuth flow so tokens rotate cleanly and tie to a Linkstacked app you can revoke without logging the user out everywhere.

3. Make your first call

Every API call is a POST to /graphql with a JSON body that contains a query and optional variables.

curl https://api.linkstacked.com/graphql \
  -H "Authorization: Bearer $LINKSTACKED_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query Me { me { _id email subscriptionTier displayName } }"
  }'

A successful response looks like:

{
  "data": {
    "me": {
      "_id": "65f...",
      "email": "you@example.com",
      "subscriptionTier": "FREE",
      "displayName": "you"
    }
  }
}

4. Read the surface that matters to you

The sidebar groups endpoints by product surface. You don't need to read left-to-right — most integrations only care about one or two:

When you're stuck, the GraphQL reference lets you introspect the schema interactively.