---
title: "Request a proposal from the firm's website (firm reviews before anything is sent or charged)"
method: POST
path: "/client-onboarding/public/proposal-signup/{firmSlug}"
tags: ["CRM Proposals"]
---

# Request a proposal from the firm's website (firm reviews before anything is sent or charged)

`POST /client-onboarding/public/proposal-signup/{firmSlug}`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/client-onboarding/public/proposal-signup/{firmSlug}`
- Auth: none required

Client-facing proposal step. No login: the opaque link token in the path is the credential, checked for existence, revocation and expiry. Rate-limited. Signing, payment setup or a past service date never charges; the firm starts billing separately. Not exposed through MCP; agents must not act as the client.

## Path parameters

- `firmSlug` string, required

## Request body

- object
  - `requestId` string, uuid, required
  - `packageId` string, uuid, required
  - `legalName` string, required
  - `signer` object, required
    - `name` string, required
    - `email` string, email, required
    - `title` string
    - `mobilePhone` string, required
  - `serviceStartDate` string, required: Calendar date YYYY-MM-DD; past service dates are allowed
  - `recurringFrom` string, nullable: Calendar date YYYY-MM-DD; past service dates are allowed
  - `attribution` object
    - `gclid` string
    - `gbraid` string
    - `wbraid` string
    - `utmSource` string
    - `utmMedium` string
    - `utmCampaign` string
    - `utmContent` string
    - `utmTerm` string
    - `gaClientId` string
    - `gaSessionId` string
    - `firstTouchAt` string, date-time
    - `adUserDataConsent` 'granted' | 'denied'
    - `consentCapturedAt` string, date-time
  - `googleAdsConsent` boolean

## Response `200`

Success

- object

## Other responses

- `400`: Invalid input
- `404`: Link not found
- `409`: The proposal changed or is no longer open
- `410`: The link expired or was replaced
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)