Contacts

Update a volunteer

Partial update — only the fields present in the body are changed. Requires contacts:write.

patch/api/v1/contacts/{id}

Request

Base URL: https://volunteerreminder.com
URL: https://volunteerreminder.com/api/v1/contacts/{id}
Auth: HTTP bearer

Path parameters

idinteger required

Contact id.

Example:4021

Request body

consent_attestedboolean

Required to be true when any contact in this request has a mobile_phone. By setting it you affirm: "I confirm these volunteers gave their mobile number to our organization and agreed to receive shift reminder texts from us, sent through VolunteerReminder, and that I can show how they agreed if asked." The affirmation is recorded with your API key id and the time, and is what we produce if a carrier audits our messaging. Omit for email-only contacts.

full_namestring

Display name. Omit to leave unchanged.

first_namestring nullable

First name. Omit to leave unchanged; null clears it.

last_namestring nullable

Last name. Omit to leave unchanged; null clears it.

email_addressstring email nullable

Email address. Omit to leave unchanged; null clears it.

mobile_phonestring nullable

Mobile phone number, used for SMS reminders. Accepts E.164 (+15125550100) or a plain 10-digit US/Canada number; normalized to E.164 on save. Send null or "" to clear it.

land_phonestring nullable

Landline phone number. Omit to leave unchanged; null clears it.

group_idinteger nullable

Id of an existing group on this account. Omit to leave unchanged; null un-groups the contact.

notesstring nullable

Free-text notes about the contact.

Example request

{
  "consent_attested": true,
  "full_name": "Ann Adams",
  "first_name": "Ann",
  "last_name": "Adams",
  "email_address": "ann@example.org",
  "mobile_phone": "+15125550100",
  "land_phone": "+15125550199",
  "group_id": 12,
  "notes": "Prefers Saturday shifts."
}

Response

The updated contact.

idnumber required

Contact id.

full_namestring required

Display name, shown on the roster and in reminder text.

first_namestring nullable required

First name, or null if not recorded separately.

last_namestring nullable required

Last name, or null if not recorded separately.

email_addressstring nullable required

Email address reminders may be sent to, or null.

mobile_phonestring nullable required

Mobile phone in E.164 format, used for SMS reminders, or null.

land_phonestring nullable required

Landline phone number (not SMS-capable, informational only), or null.

group_idnumber nullable required

Id of the group this contact belongs to, or null.

group_namestring nullable required

Display name of the group, or null when ungrouped.

notesstring nullable required

Free-text notes about the contact, or null.

created_atnumber required

Epoch milliseconds (UTC) the contact was created.

Example response

{
  "id": 4021,
  "full_name": "Ann Adams",
  "first_name": "Ann",
  "last_name": "Adams",
  "email_address": "ann@example.org",
  "mobile_phone": "+15125550100",
  "land_phone": "+15125550199",
  "group_id": 12,
  "group_name": "Sunday greeters"
}

Changes

No recorded changes to this operation across all 1 revision of this API.