Update a contact
PATCH
/contacts/{id}Autorisierung
AuthorizationBearer-Token · headererforderlichA BillionSend API key (bs_…).
Pfadparameter
idstringerforderlichmin. Länge 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
Antworten
200
Contact updated
objectstringerforderlichErlaubt:
contactidstring<uuid>erforderlich401
Missing, malformed, unknown or revoked API key
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich403
An agent acting for a role below owner and admin tried to lift the recipient's own whole-team opt-out
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich404
Not found
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich422
Validation error
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumbererforderlichnamestringerforderlichmessagestringerforderlich