---
title: "A store.eldrick.com link for a club and fitted build"
method: POST
path: "/v1/store/link"
tags: ["Store"]
---

# A store.eldrick.com link for a club and fitted build

`POST /v1/store/link`

## Request

- Base URL: `https://api.eldrick.com`
- URL: `https://api.eldrick.com/v1/store/link`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.eldrick.com/oauth/authorize`, token URL `https://api.eldrick.com/oauth/token`, scopes: `fittings:read`)

Read-only: nothing is bought or reserved. The link opens the club's product page (never checkout). Each link is recorded with its platform and fitting to measure fitting → store conversion.

## Request body

- StoreLinkRequest
  - `headId` string, required
  - `fittingId` string: A completed fitting from this account; its hand, loft, shaft, flex, length and lie fill the build.
  - `hand` 'right' | 'left'
  - `loft` string
  - `shaftId` string
  - `flex` string
  - `length` string
  - `lie` string
  - `gripId` string
  - `gripSize` 'Undersize' | 'Standard' | 'Midsize' | 'Jumbo'
  - `set` '4-PW' | '5-PW' | '6-PW'

## Response `200`

Link

- StoreLinkResponse
  - `success` unknown
  - `linkId` string
  - `url` string, uri: store.eldrick.com/club/{headId} with the build as query parameters (hand, loft, shaft, flex, length, lie, grip, gripSize, set, fit) plus utm_source/utm_medium/utm_campaign and eld_ref. Opens the product page, never checkout.
  - `club` ClubSummary
    - `id` string
    - `name` string
    - `brand` string
    - `clubType` 'driver' | 'fairway' | 'hybrid' | 'iron' | 'wedge'
    - `category` string, nullable
    - `categoryLabel` string, nullable
    - `bias` string, nullable
    - `price` number, nullable: USD; irons are priced per club
    - `pricedPer` 'club' | 'iron'
    - `image` string, nullable
    - `lofts` number[]
    - `adjustable` boolean
    - `handedness` string[]
    - `recommendedLast30Days` integer
    - `stockShaftOptions` integer
    - `storeUrl` string, uri
  - `build` object[]
    - `label` string
    - `value` string
  - `buildParams` object
  - `prefillSupported` boolean: True once store.eldrick.com's builder reads the build parameters; until then the golfer picks the build on the page.
  - `estimatedPrice` number, nullable
  - `note` string
  - `fittingId` string

## Other responses

- `400`: Validation error (shaft, grip or hand not offered on this club)
- `404`: Club or fitting not found

---

[API](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api.md) · [All operations](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api/revisions/9469c1821a83?raw)
