Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.meetergo.com/llms.txt

Use this file to discover all available pages before exploring further.

Update a user’s first name, last name, or booking slug — useful when correcting a typo or rebranding a user’s public booking URL.

​
Endpoint

PATCH /v4/user/{id}

​
Request Headers

HeaderRequiredDescription
AuthorizationYesBearer <your-api-key>
Content-TypeYesapplication/json

​
Request Body

All fields are optional. Provide only the fields you want to change — omitted fields stay unchanged.
FieldTypeDescription
givenNamestringFirst name
familyNamestringLast name
slugstringPublic booking slug. Min 5 characters; must be unique across the platform. Invalid characters are normalized automatically (e.g. "John Doe" → "john-doe").
Email is not editable here. Email changes affect the user’s login identity and require a separate flow. Contact support if you need to change a user’s email.

​
Examples

​
Fix a Typo in the Name

curl -X PATCH "https://api.meetergo.com/v4/user/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "givenName": "Jonathan",
    "familyName": "Smith"
  }'

​
Change the Booking Slug

curl -X PATCH "https://api.meetergo.com/v4/user/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "slug": "jonathan-smith" }'
The user’s public booking URL updates immediately to use the new slug.
Old booking URLs using the previous slug will return 404. If you’ve shared the old URL externally, update those references too.

​
Response

​
Success (200 OK)

Returns the full updated user object. 
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "email": "john.smith@example.com",
  "givenName": "Jonathan",
  "familyName": "Smith",
  "fullName": "Jonathan Smith",
  "slug": "jonathan-smith",
  "timezone": "Europe/Berlin",
  "companyId": "880e8400-e29b-41d4-a716-446655440003",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-16T09:12:00.000Z"
}

​
Error Responses

​
400 Bad Request — Empty Body

{
  "statusCode": 400,
  "message": "No fields to update",
  "error": "Bad Request"
}

​
400 Bad Request — Slug Too Short

{
  "statusCode": 400,
  "message": "TOO_SHORT",
  "error": "Bad Request"
}

​
400 Bad Request — Slug Already Taken

{
  "statusCode": 400,
  "message": "NOT_AVAILABLE",
  "error": "Bad Request"
}

​
403 Forbidden — Non-Admin Updating Someone Else

{
  "statusCode": 403,
  "message": "Only company admins can update other users",
  "error": "Forbidden"
}

​
404 Not Found — User Outside Your Company

{
  "statusCode": 404,
  "message": "User not found or does not belong to your company",
  "error": "Not Found"
}

​
Notes

  • Database-only update. This endpoint does not modify the user’s authentication identity (Cognito); it only updates the meetergo profile.
  • Authorization. Any authenticated user can update their own profile. Only company admins can update other users in their company.
  • Scoped to your company. You can only update users that belong to the same company as the caller.