Update emergency contact record

PUT /api/members/emergency-contacts/{id}

Overview

Replaces the details of one emergency contact record — the person a centre rings if something happens to the member while they are on site.

The record is addressed by its own id, not by member id. Take that id from Get member emergency contacts; it is assigned when the contact is created with Create emergency contact for member. The member the contact belongs to cannot be changed here, and this endpoint does not check the contact against the member in your access token — the id alone determines what is written, so validate it on your side before calling.

This is a full replacement of the record's three fields, not a partial update. All three are written unconditionally, so omitting relationship erases the stored relationship rather than leaving it in place. Send every field on every call.

Endpoint

PUT {base_url}/api/members/emergency-contacts/{id}

{base_url} is the environment URL issued to your integration. See Authenticating with Gladstone APIs.

Path parameters

NameTypeRequiredDescription
idinteger (int32)YesThe id of the emergency contact record to overwrite, as returned by Get member emergency contacts. This is the contact record's id, not the member's id.

Request body

FieldTypeRequiredDescription
contactNamestringYesThe name of the person to contact in an emergency. Maximum 50 characters. Rejected if missing or empty: A contact name is required in this request.
contactNumberstringYesThe telephone number to ring. Maximum 50 characters. Free text — no format, country-code or digits-only check is applied, so send it in whatever form your centre staff need to read. Rejected if missing or empty: A contact number is required in this request.
relationshipstringNoHow the contact is related to the member, in free text — for example Mother or Partner. Maximum 25 characters. Not validated against a list. Omitting it or sending null clears the stored relationship, because the field is written unconditionally; resend the existing value if you are not changing it.

Sample request

cURL
curl -X PUT '{base_url}/api/members/emergency-contacts/{id}' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'X-Use-SSO: true' \
  -H 'Content-Type: application/json' \
  -d '{
  "contactName": "string",
  "contactNumber": "string",
  "relationship": "string"
}'

Errors

A successful call returns 204 No Content.

StatusMeaningWhen
400Bad requestcontactName or contactNumber is missing, or a field is over its length limit — The contact name cannot be more than 50 characters, The contact numbe cannot be more than 50 characters (the typo is in the platform), The relationship cannot be more than 25 characters. Returned as a model-state object rather than a plain string.
404Not foundNo emergency contact exists with that id: Emergency contact {id} does not exist
500Internal server errorThe change could not be saved, or another unexpected server-side failure occurred. No detail is returned in the body.

This page as markdown · All pages · llms.txt