Update a contact
PATCH
/contacts/{id}Authorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Path parameters
idstringrequiredmin length 1
Request body
application/jsonfirst_namestring | nullFirst name; null clears it
last_namestring | nullLast name; null clears it
unsubscribedbooleanGlobal opt-out from all marketing sends
propertiesobjectCustom properties to set (merged); null removes a key
Responses
200
Contact updated
objectstringrequiredAllowed:
contactidstring<uuid>required401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired403
An agent acting for a role below owner and admin tried to lift the recipient's own whole-team opt-out
statusCodenumberrequirednamestringrequiredmessagestringrequired404
Not found
statusCodenumberrequirednamestringrequiredmessagestringrequired422
Validation error
statusCodenumberrequirednamestringrequiredmessagestringrequired429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired