API quickstart: first Lab call in 5 minutes

1. Create a Lab key

Open Connections → Business systems → API connections and press Create API Key: name it, set Environment to Lab, tick read + write, press Create. Copy the full key at once — it is shown only once. Lab keys start with sk_lab_, and each key works in exactly one lane (Revoke + recreate replaces a key; rotation exists only for webhook secrets).

2. Run it in Lab (UI or curl)

Easiest: open Lab (or press Test in Lab from your key card) and press Run Lab test on Typed API JSON, then Raw X12 850, then Raw EDIFACT ORDERS. From code, send the same call Lab shows — keep the route and payload unchanged as you promote; only the environment identifier and lane credential change:

curl -X POST https://app.signaledi.com/api/v1/documents/outbound \
  -H "Authorization: Bearer sk_lab_REPLACE_WITH_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: po-1042-lab-1" \
  -d '{"environment":"LAB","documentTypeCode":"850","payload":{"purchaseOrderNumber":"PO-1042","orderDate":"2026-09-24","buyer":{"id":"BUY-01","name":"RetailMart Inc"},"shipTo":{"id":"DC-01","name":"RetailMart DC 01"},"lines":[{"lineNumber":1,"sku":"SKU-100","quantity":24,"unitPrice":12.5}]}}'

3. Read the result

A pass renders a Lab result panel with partner contacted: false plus a simulated acknowledgment — Lab never contacts a trading partner and creates no billable traffic. An invalid payload returns a 422 quoting the first parser error: fix the envelope and re-run instead of filing a platform bug.

4. Verify, then promote

Confirm Recent Lab requests rows and, for webhooks, Recent Webhook Deliveries attempts. Then graduate with per-lane keys: Lab → Certification (first partner contact, real acknowledgments) → Production (Gated: live traffic only on an immutable approved version after testing, approval, and the go-live gate). Regulated data needs the BAA path completed before real documents.