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
| Header | Required | Description |
|---|
Authorization | Yes | Bearer <your-api-key> |
Content-Type | Yes | application/json |
Request Body
All fields are optional. Provide only the fields you want to change — omitted fields stay unchanged.
| Field | Type | Description |
|---|
givenName | string | First name |
familyName | string | Last name |
slug | string | Public 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" }'
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.
