Skip to main content
POST
Record an answer

Authorizations

Authorization
string
header
required

A secret key (sk_live_… / sk_test_…) from Settings → API keys. Server-side only.

Headers

Idempotency-Key
string

Any unique string per answer, e.g. your signup id.

Maximum string length: 200

Body

application/json
answer
string
required
Required string length: 1 - 2000
email
string<email>
Maximum string length: 320
external_id
string
Required string length: 1 - 200
name
string
Maximum string length: 200
question
string
Maximum string length: 500
source
enum<string>
Available options:
api,
widget,
csv,
attio,
tally,
webhook
metadata
object
answered_at
string<date-time>

Response

Replay: a response with this Idempotency-Key already exists, so nothing new was created.

id
string<uuid>
required
status
enum<string>
required
Available options:
pending,
classified,
needs_review,
failed