Create Or Bulk Upsert Contacts

POST /v2/partner/contacts

Required scopes

partner:contacts:write

Tokens missing any required scope return 401 scope_missing. See Auth & Scopes for issuance.

Operation

Operation ID	`createOrBulkUpsertContacts`
Tags	Audience

Parameters

Name	In	Type	Description
		—
X-Operator-Override	header	string	Comma-separated override flags. Standard set: destructive, bulk, force, bypass_validation=<validator>, dry_run.

Request body

Required

oneOf<items | object>

Responses

201

Created

object

Field	Type	Description
id *	id	UUID v4.
type *	enum (1)	`contact`
team_id *	id	UUID v4.
unique_id	string
name_first	string
name_last	string
name_title	string
name_suffix	string
email	string
phone_home	string
phone_mobile	string
phone_work	string
address	string
address2	string
city	string
state	string
post_code	string
county	string
country	string
birthdate	string (date)	ISO 8601 date 'YYYY-MM-DD'.
timezone	timezone	IANA timezone identifier (e.g. America/Chicago). UTC offsets rejected.
sms_verified *	boolean
sms_opted_in *	boolean
sms_authorized *	boolean
sms_unsubscribed *	boolean
email_verified *	boolean
email_opted_in *	boolean
email_authorized *	boolean
email_unsubscribed *	boolean
meta_public *	object
inserted_at *	updated_at	RFC 3339 / ISO 8601 timestamp.
updated_at *	updated_at	RFC 3339 / ISO 8601 timestamp.
last_seen_at	updated_at	RFC 3339 / ISO 8601 timestamp.
active_journey_ids *	id[]
completed_objective_keys *	string[]

403

Forbidden (override required, scope insufficient, resource-level).

object

Field	Type	Description
errors *	object[]

Example request

POST https://api.digitalonboarding.com/v2/partner/contacts
Authorization: Bearer <partner-token>
Content-Type: application/json
Idempotency-Key: <uuid-v4>

{ /* request body matching schema above */ }