Docs · Getting started

Quickstart

Go from zero to your first publish in three minutes.

Prerequisites

A workspace (create one if you don't have one).
An lbk_test_ key — generated during onboarding.
cURL or any HTTP client.

1. Create a listing

Connect a Leboncoin sandbox account first, then POST to /api/v1/accounts/{account_id}/listings with a signed request and an idempotency key.

POST /api/v1/accounts/{account_id}/listings

TS=$(date +%s)
METHOD='POST'
ACCOUNT_ID='b62e8a44-715b-4b81-9a20-826797be9f6a'
REQUEST_PATH="/api/v1/accounts/$ACCOUNT_ID/listings"
QUERY=''
IDEMPOTENCY_KEY=$(uuidgen)
BODY='{"title":"Nike Air Max 90","description":"Original pair in very good condition","price":89,"currency":"EUR","category_id":"22","location":{"city":"Paris","zipcode":"75011"},"attributes":{"clothing_type":"1","clothing_condition":"3","clothing_color":"bleu"},"photo_urls":["https://cdn.example.com/photo.jpg"]}'
BODY_SHA256=$(printf '%s' "$BODY" | openssl dgst -sha256 -hex | awk '{print $2}')
IDEMPOTENCY_SHA256=$(printf '%s' "$IDEMPOTENCY_KEY" | openssl dgst -sha256 -hex | awk '{print $2}')
CANONICAL=$(printf 'listbridge-hmac-v1\ntimestamp:%s\nmethod:%s\npath:%s\nquery:%s\nidempotency-key-sha256:%s\nbody-sha256:%s' \
  "$TS" "$METHOD" "$REQUEST_PATH" "$QUERY" "$IDEMPOTENCY_SHA256" "$BODY_SHA256")
SIG=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$HMAC_SECRET" -hex | awk '{print $2}')

curl -X "$METHOD" "https://api.listbridge.io$REQUEST_PATH" \
  -H "Authorization: Bearer lbk_test_xxx" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: v1=$SIG" \
  -H "Content-Type: application/json" \
  -d "$BODY"
# 201 Created · { "id": "c1b2a3d4-0000-4000-8000-000000000000", "marketplace": "leboncoin", "marketplace_listing_id": "2938", "status": "published" }

2. Wait for the webhook

A configured endpoint receives listing.published after a successful publish. Delivery retries follow the documented backoff schedule.

listing.published payload

{
  "id": "9f6f2b0e-6a24-4a1b-9d3e-4a1f0c2b7e91",
  "event": "listing.published",
  "created_at": "2026-07-10T12:34:56Z",
  "mode": "live",
  "data": {
    "listing_id": "c1b2a3d4-0000-4000-8000-000000000000",
    "marketplace_listing_id": "m_8f2cn4q",
    "status": "published"
  }
}