APICRMContactsCreate Contact

Create Contact

Create a CRM contact. No field is strictly required; when email is empty a placeholder address is stored. Defaults: leadStatus New, type lead, source Website. companyId must be a company in your organization (the company name is then copied from it) and ownerId must be a user in your organization (otherwise it is ignored). dedupBy controls duplicate detection: email (default), name, company, phone, or none. A duplicate returns 409. Responds 201 with the created contact and runs any contact_created CRM workflows.

Created: September 16, 2026

Updated: September 16, 2026

Overview

POST

https://dashboard.vinsi.ai/api/crm/contacts

Request

Headers

Content-Type

string

application/json

x-api-key

string

REQUIRED

Request Body

{25 items"firstName":string"Alex"
"lastName":string"Morgan"
"email":string"alex.morgan@example.com"
"phone":string"+15555550142"
"ext":string""
"email2":string""
"phone2":string""
"phone2Ext":string""
"phone3":string""
"phone3Ext":string""
"title":string"Office Manager"
"company":string"Acme Dental"
"companyId":int318
"leadStatus":string"New"
"type":string"lead"
"source":string"Website"
"disposition":string""
"ownerId":string"cmexampleuser0000000000001"
"address":string"100 Main St"
"city":string"San Diego"
"state":string"CA"
"zip":string"92101"
"country":string"US"
"notes":string"Asked for a callback next week..."
"dedupBy":string"email"
}

Response

{35 items"id":int1042
"organizationId":string"cmexampleorg00000000000001"
"firstName":string"Alex"
"lastName":string"Morgan"
"email":string"alex.morgan@example.com"
"phone":string"+15555550142"
"company":string"Acme Dental"
"leadStatus":string"New"
"type":string"lead"
"source":string"Website"
"notes":string"Asked for a callback next week..."
"ownerId":string"cmexampleuser0000000000001"
"createdAt":string"2026-09-10T17:22:57.000Z"
"updatedAt":string"2026-09-12T15:04:11.000Z"
"ext":string""
"disposition":string""
"lastWorkDate":null
"state":string"CA"
"phone2":string""
"phone2Ext":string""
"phone3":string""
"phone3Ext":string""
"title":string"Office Manager"
"isUnsubscribed":boolfalse
"unsubscribedAt":null
"email2":string""
"companyId":int318
"address":string"100 Main St"
"city":string"San Diego"
"zip":string"92101"
"country":string"US"
"avatarUrl":null
"phoneNorm":string"5555550142"
"phone2Norm":null
"phone3Norm":null
}

Endpoint Explorer

Note: You must be already authenticated on https://dashboard.vinsi.ai/ to use this API tester.

POST

Headers

Content-Type: *

x-api-key: *

Response

No response yet. Click Send to test the API.