Update contact details

patch

https://api.popt.in/v1/contacts/{uid}

Update an existing contact's field values, tags, or preferences by public id (uid) without sending or changing their subscription status - use this for CRM syncs that must never resubscribe someone who opted out.

Send only the keys you want to change; at least one of info, custom, tags, or preferences is required. Fields you send are overwritten and omitted fields are left unchanged. tags and preferences replace the full set when present.

status is not accepted (use Update contact status), and EMAIL cannot be changed. Blocklisted contacts can be updated and stay blocklisted. Restricted and suspended contacts cannot be updated (423). 423 if the account is locked for processing.

Path Params

uid

string

required

Body Params

info

object | null

Default contact fields keyed by field tag (e.g. FIRST_NAME, BIRTHDAY, COUNTRY). Keys are case-insensitive and must exist on your mail list. Only the fields you send are overwritten; omitted fields are left unchanged. EMAIL cannot be changed. COUNTRY accepts an ISO country code. BIRTHDAY must be a date that is not in the future.

custom

object | null

Mail-list custom fields keyed by tag (e.g. CUSTOM_1). Keys are case-insensitive; values are validated against each field's type (text, number, date, boolean). Only the fields you send are overwritten.

200ContactUpdatedResponse

401Unauthenticated.

403ForbiddenError

404ResourceNotFoundError

422Validation failed.

423AccountProcessingError

429TooManyRequestsError