Measure MapAPI
Help CenterGet an API key

Update a member

PUT/users/{uid}
users:write Enterprise
Changes a member's details or role. Only the fields you send change; an empty string clears a field, except the name, which a member always keeps. Your own account cannot be changed here.

Path parameters

  • uidstringrequired
    The ID of a member of your organisation.

Request body application/json

Fields of MemberUpdate:

  • fullNamestring
    at most 120 characters
  • companystring
    at most 120 characters
  • addressstring
    at most 300 characters
  • zipCodestring
    at most 20 characters
  • countrystring
    at most 80 characters
  • phoneNumberstring
    at most 40 characters
  • enterpriseRolestring
    A member's role in the organisation. user is shown as Member in the app.
    One ofadminmanageruserviewer
  • metadataobject (any fields)
    Your own data about the member, such as their ID in your CRM. Replaces what was there.

Responses

  • Success:

    • successbooleanrequired
      Alwaystrue

Errors

A failed request answers with one of these, in an Error body.

400invalid_bodyA value in the request body is missing, has the wrong type, is too long or is not one of the accepted values.
400invalid_uidThe person's ID in the path is missing or blank.
401unauthorized_actionThe item is not on your account or your members', the request came from a web page on a website the key does not allow, or the action is not allowed for this person.
403insufficient_scopeThe key does not have the access this endpoint needs. Create a key with that access.
403scope_not_in_planYour plan does not include this endpoint, for example members on Open Guest.
403subscription_expiredYour subscription is not active. Update your payment method in the app.
404user_not_foundThe person does not exist or is not a member of your organisation.

Try it

This key is

The key stays in this tab and goes only to the API. Use a sandbox key while you try things: requests are real, and what they change is changed.

PUT https://api.measuremaponline.com/api/v1/users/m3K8qZxLpV4NrT2w

Fill in your API key to send.

As a cURL command
Shell
curl -X PUT 'https://api.measuremaponline.com/api/v1/users/m3K8qZxLpV4NrT2w' \
  -H "Authorization: $MMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "phoneNumber": "+44 20 7946 0958",
  "enterpriseRole": "manager"
}'