PUT User

Updates the user with the specified ID.

Request URL


Request Parameters

userID Property is required The ID of the user to update. This value overwrites whatever is supplied in User.UserID. The UserID is returned in the GET Users call.

Note: The API user must have role access permissions enabled for Edit User Profile Data and Custom Fields. Optionally, impersonate a Platform Manager to grant the proper permissions.

Request Body

A valid XML or JSON User as noted below. Must be an admin to update HostID.

  "Email": "MadisonAbelle@blackbaud.com",
  "MaidenName": "Smith",
  "NickName": "",
  "Prefix": "Mrs.",
  "CustomField1": "Custom content",
  "FieldsToNull": ["MiddleName"]

Example using curl:

curl -X PUT \
  'https://{school}.myschoolapp.com/api/user/1574489?t={token}&format=json' \
  -H 'content-type: application/json' \
  -d '{"MaidenName": "Smith", "CustomField1": "Custom content"}'

Response 200

Returned when the operation successfully edits the user.


UserID Read only integer
FirstName string
LastName string
Email string
HostId string
Greeting string
MaidenName string
NickName string
Prefix string
Suffix string
MiddleName string
OtherLastName string
Affiliation string
Gender string
BirthDate date

Extended Properties

These fields are returned by /user/extended/(userID)/ in addition to the above field(s).

EthnicityType integer
Citizenship string
PersonalWebsite integer
BoardingOrDay integer
IsDeceased boolean
DeceasedDate date
LivingStatus string
IsAbroad boolean
ScreenName string
IMService string
IsLost boolean
CustomField1 - 10 string

Audit Properties

These fields are returned by /user/audit/.

PrimaryKey integer
FieldName string
SourceBefore string
SourceAfter string
ChangeDate date
DeceasedDate date
HandledInd boolean
DownloadedInd boolean


StudentInfo Basic information about enrollment status. StudentInfo

Extended Connections

These connections are returned by /user/extended/(userID)/ in addition to the above connection(s).

AddressList Array of Address
PhoneList Array of Phone
OccupationList Array of Occupation
EducationList Array of Education
Relationships Array of Relationship
ProfilePhoto PhotoItem


Have a question? See a problem with our docs? Want to engage with the ON API team? Please visit us on the ON API Community!