API Reference
  1. Preczn API
  2. Merchant Contacts

Create a merchant contact (canonical-dedup)

post
https://api.preczn.com/v1/merchants//contacts

Creates a new contact on the merchant. The canonical key is (firstName.trim(), lastName.trim(), email.trim().toLowerCase()). If a contact with the same canonical key already exists on this merchant, the existing record is returned with HTTP 200 (no new row is created). A genuinely new contact returns HTTP 201.

Path Params
string
required

The Preczn merchant to attach the contact to.

Body Params
string
required
length ≤ 255

Contact's first name.

string
required
length ≤ 255

Contact's last name.

string
required
length ≤ 255

Contact's email. Normalized to lowercase on write.

string
required
length ≤ 14

Contact phone in strict E164 format (+1XXXXXXXXXX). Required. Any other format — display "(NNN) NNN-NNNN", bare 10-digit, or dash/dot-separated — is rejected with HTTP 400.

string
length ≤ 255

Optional job title.

string
length ≤ 1000

Optional free-form notes.

Responses

401

Unauthorized (test-mode mismatch).

403

Forbidden (platform mismatch).

404

Merchant not found.

Updated 5 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 days ago

Did this page help you?