Create Contact | PLEX-DEMO

curl -X POST https://connect.plex.com/crm/v1/contacts \
     -H "Content-Type: application/json" \
     -d '{
  "customerId": "00000000-0000-0000-0000-000000000000",
  "firstName": "John",
  "lastName": "Smith",
  "supplierId": "00000000-0000-0000-0000-000000000000",
  "phone": "+1-555-0123",
  "fax": "+1-555-0124",
  "mobilePhone": "+1-555-0125",
  "title": "Purchasing Manager",
  "note": "Primary contact for purchasing decisions",
  "email": "john.smith@example.com",
  "companyName": "ACME Corporation",
  "officeAddress": "123 Business St, Suite 100, New York, NY 10001",
  "homeAddress": "456 Residential Ave, Brooklyn, NY 11201",
  "private": 0,
  "description": "Main purchasing contact for ACME Corp",
  "birthDate": "1985-03-15T00:00:00Z",
  "url": "https://www.linkedin.com/in/johnsmith",
  "sortOrder": 1,
  "type": "Business"
}'

{
  "id": "contact-123e4567-e89b-12d3-a456-426614174000",
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "firstName": "John",
  "lastName": "Smith",
  "supplierId": "00000000-0000-0000-0000-000000000000",
  "phone": "+1-555-0123",
  "fax": "",
  "mobilePhone": "",
  "title": "Purchasing Manager",
  "note": "",
  "email": "john.smith@example.com",
  "companyName": "ACME Corporation",
  "officeAddress": "",
  "homeAddress": "",
  "private": 0,
  "description": "",
  "birthDate": "1985-03-15T00:00:00.00Z",
  "url": "",
  "sortOrder": 1,
  "type": "Business",
  "associatedWithId": "00000000-0000-0000-0000-000000000000",
  "modifiedById": "user-001",
  "modifiedDate": "2026-02-10T20:50:00.00Z",
  "createdById": "user-001",
  "createdDate": "2026-02-10T20:50:00.00Z"
}

Create a new contact record in the Plex system.

Request

This endpoint expects an object.

customerIdstringOptional

firstNamestringOptional

lastNamestringOptional

supplierIdstringOptional

phonestringOptional

faxstringOptional

mobilePhonestringOptional

titlestringOptional

notestringOptional

emailstringOptionalformat: "email"

companyNamestringOptional

officeAddressstringOptional

homeAddressstringOptional

privateintegerOptional

descriptionstringOptional

birthDatedatetimeOptional

urlstringOptionalformat: "uri"

sortOrderintegerOptional

typestringOptional

Response

Created

idstringOptional

customerIdstringOptional

firstNamestringOptional

lastNamestringOptional

supplierIdstringOptional

phonestringOptional

faxstringOptional

mobilePhonestringOptional

titlestringOptional

notestringOptional

emailstringOptionalformat: "email"

companyNamestringOptional

officeAddressstringOptional

homeAddressstringOptional

privateintegerOptional

descriptionstringOptional

birthDatedatetimeOptional

urlstringOptional

sortOrderintegerOptional

typestringOptional

associatedWithIdstringOptional

modifiedByIdstringOptional

modifiedDatedatetimeOptional

createdByIdstringOptional

createdDatedatetimeOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error