> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Create a Contact
> Create a Contact via API.
Available in
🇮🇳 India
🇸🇬 Singapore
🇺🇸 United States
Use this endpoint to create a new contact.
* A new contact is created if any combination of the following details is unique: `name`, `email`, `contact`, `type` and `reference_id`.
* If **all** the above details match the details of an existing contact, the API returns details of the existing contact.
```bash Curl theme={null}
curl -u : \
-X POST https://api.razorpay.com/v1/contacts \
-H "Content-Type: application/json" \
-d '{
"name":"Gaurav Kumar",
"email":"gaurav.kumar@example.com",
"contact":"9000090000",
"type":"employee",
"reference_id":"Acme Contact ID 12345",
"notes":{
"notes_key_1":"Tea, Earl Grey, Hot",
"notes_key_2":"Tea, Earl Grey… decaf."
}
}'
```
```json Success theme={null}
{
"id": "cont_00000000000001",
"entity": "contact",
"name": "Gaurav Kumar",
"contact": "9000090000",
"email": "gaurav.kumar@example.com",
"type": "employee",
"reference_id": "Acme Contact ID 12345",
"batch_id": null,
"active": true,
"notes": {
"notes_key_1": "Tea, Earl Grey, Hot",
"notes_key_2": "Tea, Earl Grey… decaf."
},
"created_at": 1545320320
}
```
## Request Parameters
The contact's name. This field is case-sensitive. A minimum of 3 characters and a maximum of 50 characters are allowed. Name cannot end with a special character, except `.`. Supported characters: `a-z`, `A-Z`, `0-9`, `space`, `’` , `-` , `_` , `/` , `(` , `)` and , `.`. For example, `Gaurav Kumar`.
The contact's email address. For example, `gaurav.kumar@example.com`.
The contact's phone number. For example, `9000090000`.
Maximum 40 characters. Classification for the contact being created. For example, `employee`. The following classifications are available by default:
* `vendor`
* `customer`
* `employee`
* `self`
Additional classifications can be created via the [Dashboard](https://x.razorpay.com/) and then used in APIs. It is not possible to create new classifications via API.
Maximum 40 characters. A user-entered reference for the contact. For example, `Acme Contact ID 12345`.
Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs, 256 characters (maximum) each. For example, `"note_key": "Beam me up Scotty”`.
## Response Parameters
The unique identifier linked to the contact. For example, `cont_00000000000001`.
The entity being created. Here, it is `contact`.
The contact's name. For example, `Gaurav Kumar`.
The contact's phone number. For example, `9000090000`.
The contact's email address. For example, `gaurav.kumar@example.com`.
A classification for the contact being created. For example, `employee`.
A user-entered reference for the contact. For example, `Acme Contact ID 12345`.
This value is returned if the contact was created as part of a bulk upload. For example, `batch_00000000000001`.
Possible values:
* `true` (default) : active
* `false` : inactive
Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs, 256 characters (maximum) each. For example, `"note_key": "Beam me up Scotty”`.
Timestamp, in Unix, when the contact was created. For example, `1545320320`.