> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wristler.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> A token, and your first call.

**1. Get your client**

A seller running their own script creates one themselves: **Trader → Settings
→ Integrations**. They get a client id and a secret, and the secret is shown
once — we store only a hash of it.

A product used by several sellers is registered by us instead. Mail
[support@wristler.eu](mailto:support@wristler.eu) with the name sellers will see on
the consent screen and your redirect URI.

**2. Ask for a token**

A seller's own script uses client credentials — no browser, no redirect:

```bash theme={null}
curl -X POST https://api.wristler.eu/oauth/token \
  -d grant_type=client_credentials \
  -d client_id=$WRISTLER_CLIENT_ID \
  -d client_secret=$WRISTLER_CLIENT_SECRET \
  -d 'scope=watches:read watches:write orders:read'
```

A product several sellers connect to uses the authorization code flow with
PKCE instead, so each seller approves you themselves.
[Both flows, in full →](https://docs.wristler.eu/guides/authentication.md)

**3. Paste it into the playground**

Every page in the API reference has a **Bearer token** field. Paste the
`access_token` from the previous step into it and the console calls the API as
you — it does not run the OAuth flow itself, which is why that step is a call of
its own.

Pick the environment from the server dropdown at the top of the page. A token is
good for one environment: a production client id does not work on staging.

**4. Check it works**

```bash theme={null}
curl https://api.wristler.eu/v1/me \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/vnd.api+json"
```

This needs no scope. If it answers, your token is good.

**5. Find the business you act for**

```bash theme={null}
curl "https://api.wristler.eu/v1/sellers" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/vnd.api+json"
```

Exactly the businesses that granted you access, and nothing else — so you never
have to be told an id out of band. Every address below takes one of these ids.

**6. Read their stock**

```bash theme={null}
curl "https://api.wristler.eu/v1/sellers/42/watches?page[limit]=25" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/vnd.api+json"
```

Everything they have: drafts and sold listings included, which the public
catalogue deliberately does not give you.

## What to build next

> [card] [Sync an inventory](https://docs.wristler.eu/guides/inventory.md)
>
> Creating and updating listings, and the one field that makes the rest easy.

> [card] [Pull orders](https://docs.wristler.eu/guides/orders.md)
>
> Incremental pulls, and recording a shipment.

> [!WARNING]
>
> Send an `Idempotency-Key` on every write you might retry. A network error tells
> you nothing about whether the write landed; that header does.
> [How it works →](https://docs.wristler.eu/concepts/idempotency.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.