Skip to main content
POST
/
contacts
Create Contact
curl --request POST \
  --url https://services.leadconnectorhq.com/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Version: <version>' \
  --data '
{
  "locationId": "ve9EPM428h8vShlRW1KT",
  "firstName": "Rosan",
  "lastName": "Deo",
  "name": "Rosan Deo",
  "email": "rosan@deos.com",
  "gender": "male",
  "phone": "+1 888-888-8888",
  "address1": "3535 1st St N",
  "city": "Dolomite",
  "state": "AL",
  "postalCode": "35061",
  "website": "https://www.tesla.com",
  "timezone": "America/Chihuahua",
  "dnd": true,
  "dndSettings": {
    "Call": {
      "status": "active",
      "message": "<string>",
      "code": "<string>"
    },
    "Email": {
      "status": "active",
      "message": "<string>",
      "code": "<string>"
    },
    "SMS": {
      "status": "active",
      "message": "<string>",
      "code": "<string>"
    },
    "WhatsApp": {
      "status": "active",
      "message": "<string>",
      "code": "<string>"
    },
    "GMB": {
      "status": "active",
      "message": "<string>",
      "code": "<string>"
    },
    "FB": {
      "status": "active",
      "message": "<string>",
      "code": "<string>"
    }
  },
  "inboundDndSettings": {
    "all": {
      "status": "active",
      "message": "<string>"
    }
  },
  "tags": [
    "nisi sint commodo amet",
    "consequat"
  ],
  "customFields": [
    {
      "id": "6dvNaf7VhkQ9snc5vnjJ",
      "key": "my_custom_field",
      "field_value": "My Text"
    }
  ],
  "source": "public api",
  "dateOfBirth": "1990-09-25",
  "country": "US",
  "companyName": "DGS VolMAX",
  "assignedTo": "y0BeYjuRIlDwsDcOHOJo"
}
'
{
  "contact": {
    "id": "seD4PfOuKoVMLkEZqohJ",
    "dateAdded": "2021-08-31T09:59:41.937Z",
    "dateUpdated": "2021-08-31T09:59:41.937Z",
    "deleted": false,
    "tags": [
      "nisi sint commodo amet",
      "consequat"
    ],
    "type": "read",
    "customFields": [
      {
        "id": "MgobCB14YMVKuE4Ka8p1",
        "value": "name"
      }
    ],
    "locationId": "ve9EPM428h8vShlRW1KT",
    "firstName": "rubika",
    "firstNameLowerCase": "rubika",
    "fullNameLowerCase": "rubika deo",
    "lastName": "Deo",
    "lastNameLowerCase": "deo",
    "email": "rubika@deos.com",
    "emailLowerCase": "rubika@deos.com",
    "bounceEmail": false,
    "unsubscribeEmail": false,
    "dnd": true,
    "dndSettings": {
      "Call": {
        "status": "active",
        "message": "<string>",
        "code": "<string>"
      },
      "Email": {
        "status": "active",
        "message": "<string>",
        "code": "<string>"
      },
      "SMS": {
        "status": "active",
        "message": "<string>",
        "code": "<string>"
      },
      "WhatsApp": {
        "status": "active",
        "message": "<string>",
        "code": "<string>"
      },
      "GMB": {
        "status": "active",
        "message": "<string>",
        "code": "<string>"
      },
      "FB": {
        "status": "active",
        "message": "<string>",
        "code": "<string>"
      }
    },
    "phone": "+18832327657",
    "address1": "3535 1st St N",
    "city": "ruDolomitebika",
    "state": "AL",
    "country": "US",
    "postalCode": "35061",
    "website": "https://www.tesla.com",
    "source": "public api",
    "companyName": "DGS VolMAX",
    "dateOfBirth": "Date format will be  YYYY-MM-DDTHH:mm:ss.sssZ and  Example 1990-09-25T00:00:00.000Z",
    "birthMonth": 8,
    "birthDay": 25,
    "lastSessionActivityAt": "2021-07-16T11:39:30.564Z",
    "offers": [],
    "products": [],
    "businessId": "641c094001436dbc2081e642",
    "assignedTo": "y0BeYjuRIlDwsDcOHOJo"
  }
}

Authorizations

​
Authorization
string
header
required

Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.

Headers

​
Version
enum<string>
required

API Version

Available options:
2021-07-28

Body

application/json
​
locationId
string
required
Example:

"ve9EPM428h8vShlRW1KT"

​
firstName
string | null
Example:

"Rosan"

​
lastName
string | null
Example:

"Deo"

​
name
string | null
Example:

"Rosan Deo"

​
email
string | null
Example:

"rosan@deos.com"

​
gender
string
Example:

"male"

​
phone
string | null
Example:

"+1 888-888-8888"

​
address1
string | null
Example:

"3535 1st St N"

​
city
string | null
Example:

"Dolomite"

​
state
string | null
Example:

"AL"

​
postalCode
string
Example:

"35061"

​
website
string | null
Example:

"https://www.tesla.com"

​
timezone
string | null
Example:

"America/Chihuahua"

​
dnd
boolean
Example:

true

​
dndSettings
object
​
inboundDndSettings
object
​
tags
string[]
Example:
["nisi sint commodo amet", "consequat"]
​
customFields
object[]
​
source
string
Example:

"public api"

​
dateOfBirth
object

The birth date of the contact. Supported formats: YYYY/MM/DD, MM/DD/YYYY, YYYY-MM-DD, MM-DD-YYYY, YYYY.MM.DD, MM.DD.YYYY, YYYY_MM_DD, MM_DD_YYYY

Example:

"1990-09-25"

​
country
string
Example:

"US"

​
companyName
string | null
Example:

"DGS VolMAX"

​
assignedTo
string

User's Id

Example:

"y0BeYjuRIlDwsDcOHOJo"

Response

Successful response

​
contact
object
Last modified on March 4, 2026