# Contact Fields

Contact Fields let you define custom input fields that appear when creating a contact, in addition to the built-in name/phone/email.

_Last updated: 2026-09-11_


## Overview

Contact Fields let you define custom input fields that appear when creating a contact, in addition to the built-in name/phone/email. Custom fields can also be referenced from Automation.

## Open Settings

### Step 1 — Open Settings

From the left navigation, click Settings, then click Contact Fields.

## Manage custom contact fields

### Step 2 — Manage custom contact fields

Click Add field to create a new custom field. Each field has a display Input field name and a Webhook key — the key used to send and receive its value through the webhook, shown under custom_fields in an incoming contact payload. The table also shows the field's Input type, whether it Is required, and its Status.

> **NOTE: Fields are matched by webhook key, not display name**
> If you're integrating with the webhook, use the exact webhook key shown in the table (for example company_details) — renaming a field's display name later doesn't change its key.

## Example: sending custom field values via webhook

The panel shows a live example of the payload shape — custom field values are sent (and returned) under custom_fields, keyed by each field's webhook key:

```json
{
  "name": "John Doe",
  "phone": "+919876543210",
  "custom_fields": {
    "company_details": "Company Details value",
    "test_number": "Test Number value",
    "leadid": "leadid value",
    "leadtype": "leadtype value"
  }
}
```

### Field reference

| Input field name | Webhook key | Is required |
| --- | --- | --- |
| Company Details | company_details | Yes |
| Test Number | test_number | No |
| leadid | leadid | No |
| leadtype | leadtype | No |

## Expected result

The new field appears in the contact creation form, and its value is readable and writable through the webhook using the key shown in the table.

## Related articles

- [Connect Your WhatsApp Business Account](/docs/admin-setup-connect-whatsapp) — View your connected WhatsApp Business Account details from Settings.
- [General Settings](/docs/admin-setup-general-settings) — General Settings holds your organization's basic details, along with a few account-wide message behaviors: automatic retry for failed campaign messages, an auto-reply for message types WhatsApp doesn't support (like polls), and keyword-based opt-out..
- [Notification Settings](/docs/admin-setup-notifications) — Notification Settings controls the sound your browser plays when a new message arrives, so you don't have to keep an eye on the Chats tab to know when someone messages you..
- [Security Settings](/docs/admin-setup-security) — Security Settings is where you change your account password..