/bff/contact/email-upsert

Idempotent on (contact, lower(email)). When the same email already exists on the contact, the row is updated; otherwise a new row is inserted. Position auto-fills as "max + 1" when omitted.

ContactpostBffContactEmail-upsert

Parameters

8 body

8 total

Body · 8

customerIdstringRequired

Contact external ID.

idnumber

Existing row id — provide to update; omit to insert (or upsert by email).

emailstringRequired

Email address.

labelstring

Role label.

sendInvoicesboolean

Receive invoices? Default true.

sendRemindersboolean

Receive overdue reminders? Default true.

sendMarketingboolean

Receive marketing? Default false.

positionnumber

Display order; auto-assigned to "max + 1" when omitted.

Request

POST /bff/contact/email-upsert

post

curl -X POST "https://api.bizkithub.com/bff/contact/email-upsert" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "customerId": "abc123def456ghij",
  "id": 0,
  "email": "accountant@client.cz",
  "label": "Účetní",
  "sendInvoices": false,
  "sendReminders": false,
  "sendMarketing": false,
  "position": 0
}'

Response

JSON payload

{
  "id": 0,
  "inserted": false
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key