Create a person

Create a person

Required scopes: people:write

Accepts both publishable (ys_pk_*) and secret (ys_sk_*) keys. Use a publishable key when posting from a browser intake form (the example below); use a secret key with people:write for server-to-server flows — the canonical create path before POST /v1/applications, which requires person_id.

Example (curl):

curl -X POST https://api.yardstick.team/v1/people \
  -H 'Authorization: Bearer ys_pk_live_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 7c3a…' \
  -d '{"email":"alex@example.com","name":"Alex Lee"}'

Example (TypeScript):

await fetch("https://api.yardstick.team/v1/people", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.YS_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({ email: "alex@example.com", name: "Alex Lee" }),
});