Skip to main content
PATCH
Partially Update a Donor Phone Number
Send just the fields you want changed — for example value or countryCode — and the rest stay as they are. Returns the updated phone number.

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Path Parameters

id
integer<int64>
required

The ID of the donor the phone number belongs to.

phoneId
integer<int64>
required

The ID of the phone number.

Body

The partial phone number update request.

Represents a partial contact method request for PATCH operations. All properties are optional to allow partial updates.

type
enum<integer> | null

The type of contact method, such as Email, Phone, or Mobile.

Available options:
0,
10,
11,
12,
20,
21,
22,
99
value
string | null

The email address or phone number itself.

Maximum string length: 200
isPrimary
boolean | null

Whether this is the donor's primary contact method of its type.

isOptedIn
boolean | null

Whether the donor has opted in to being contacted at this value.

countryCode
string | null

The country calling code of a phone number, such as 1 for the United States.

Response

OK

Represents a donor contact method model.

id
integer<int64>

The unique identifier of the contact method.

donorId
integer<int64>

The unique identifier of the donor.

type
enum<integer>

The type of contact method, such as Email, Phone, or Mobile.

Available options:
0,
10,
11,
12,
20,
21,
22,
99
typeDisplay
string | null

The display name of the contact method type.

value
string | null

The email address or phone number itself.

secondaryValue
string | null

The extension or other secondary part of the value.

isPrimary
boolean

Whether this is the donor's primary contact method of its type.

isOptedIn
boolean

Whether the donor has opted in to being contacted at this value.

isValid
boolean

Whether the contact method is valid.

isEmail
boolean

Whether the contact method is an email address.

isPhone
boolean

Whether the contact method is a phone number.

isBounced
boolean

Whether email sent to this address has bounced.

countryCode
string | null

The country calling code of the phone number, such as 1 for the United States.

Last modified on July 28, 2026