---
title: "Register agent contact info"
method: POST
path: "/agent/v1/contact"
tags: ["Agent"]
---

# Register agent contact info

`POST /agent/v1/contact`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/agent/v1/contact`
- Auth: API key in header `SIGN-IN-WITH-X`

Register or update agent contact info (name, email, webhook) tied to the wallet. New or changed emails start an operator reply challenge and remain email_pending until the mailbox owner replies. Requires wallet auth, free within tier.

## Headers

- `SIGN-IN-WITH-X` string, required

## Request body

- object
  - `name` string, required: Agent name (required)
  - `email` string: Contact email (optional)
  - `webhook` string: Webhook URL, must be https (optional)

## Response `200`

Contact info saved

- object
  - `wallet` string
  - `name` string
  - `email` string
  - `webhook` string
  - `updated_at` string, date-time
  - `email_verification_status` 'none' | 'pending' | 'verified'
  - `passkey_binding_status` 'none' | 'pending' | 'verified'
  - `assurance_level` 'wallet_only' | 'email_pending' | 'email_verified' | 'passkey_pending' | 'operator_passkey': Operational assurance label. This is mailbox/passkey continuity, not a humanhood or uniqueness claim.
  - `email_verified_at` string, date-time, nullable
  - `email_verified_message_id` string, nullable
  - `email_challenge_sent_at` string, date-time, nullable
  - `passkey_bound_at` string, date-time, nullable
  - `active_operator_passkey_id` string, uuid, nullable
  - `verification_retry_after_seconds` integer: Present when a pending email challenge is cooling down.
  - `enrollment_sent_to` string: Present after passkey enrollment request; token is emailed and never returned.

## Other responses

- `400`: Validation error (missing name, invalid email, non-https webhook)
- `401`: Missing or invalid authentication. Run402-originated JSON bodies use the canonical ErrorEnvelope.

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)