# /form — TSN Relay

POST /form provisions an encrypted inbox, generates an ECDH keypair, and returns a shareable form link and embed snippet.

## Purpose

POST /form provisions an encrypted inbox, generates an ECDH keypair, and returns a shareable form link and embed snippet.

Price: $0.01 USDC

## Request

```
POST /form {"name":"Contact","fields":[{"name":"email","label":"Email","type":"email"}]}
```

## Input

- `name` — example: `Contact`
- `fields` — example: `[{'name': 'email', 'label': 'Email', 'type': 'email'}]`

## Response

```json
{
  "ok": true,
  "namespace": "a1b2c3d4",
  "formUrl": "https://relay.thesoulnetwork.eu/form#ns=a1b2c3d4"
}
```

## Payment

No API key. Call once to receive `402 Payment Required` with the x402
terms, pay $0.01 USDC on Base Mainnet via https://x402.thesoulnetwork.eu, then send the 1-hour ticket as
`Authorization: Bearer <ticket>`.
