Update Customer
Updates customer details.
PATCH /api/customers/:customerPublicId
Authentication
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"Request Body
All fields are optional. Omitted fields keep their current values.
{
"name": "New Name",
"email": "new@deinkunde.com",
"status": "active",
"packageType": "business", // configured packageType or displayName for the organization
"notificationEmail": "alerts@customer-a.de",
"notificationPhoneNumber": "+491701234567",
"monthlyReportsEnabled": true,
"companyName": "Nordwind ApS",
"emailLanguage": "en",
"customFields": {
"internalReference": "KD-999"
}
}Notes:
packageTypecan contain the configured package key or the package display name of the organization. Known aliases such asaquisition_testare normalized automatically. A value that resolves to no package of this organization is rejected with400anddata.codeinvalidPackageType; it is no longer stored as-is.companyNameis optional: the customer's company name, shown as "Company" on the customer page. Empty ornullclears it.emailLanguagesets the language of the e-mails this customer receives (alerts, reports, status pages):de,enorda.nullreturns it to the organization's language. Text messages to this customer use the same language. Any other value is rejected with400.
Ownership & permission overrides (optional)
These fields control the customer's managed vs. self-service permissions and channel-type policy. They are organization-write gated: a customer-scoped caller's writes to these fields are silently ignored server-side.
null means inherit from the customer's package config.
| Field | Type | Default | Description |
|---|---|---|---|
allowSelfService | boolean|null | null (inherit) | Whether the customer may create and manage self_service monitors |
maxSelfServiceUrls | number|null | null (inherit) | Cap on the customer's total self_service monitors across all monitor types |
canEditManaged | boolean | false | Exception: lets this customer edit managed monitors (class flips stay org-only). Changes are written to the audit log. |
enableEmailAlerts | boolean|null | null (inherit) | Whether your organization's own email channels alert about this customer (null = follow the package). Never affects channels the customer sets up themselves |
enableSmsAlerts | boolean|null | null (inherit) | Whether your organization's own SMS channels alert about this customer (null = follow the package). Never affects channels the customer sets up themselves |
enableWebhookAlerts | boolean|null | null (inherit) | Whether your organization's own webhooks channels alert about this customer (null = follow the package). Never affects channels the customer sets up themselves |
enableIntegrationAlerts | boolean|null | null (inherit) | Whether your organization's own integrations channels alert about this customer (null = follow the package). Never affects channels the customer sets up themselves |
enablePostRequestEscalation | boolean|null | null (inherit) | Channel-type policy override: POST-request escalation |
The legacy notificationChannels JSONB override is deprecated: channel-type policy lives in the enable* fields above.
Example Request
curl -X PATCH "$BASE_URL/api/customers/6bfec6f6-245a-47ce-843b-157d97d56f88" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Customer A GmbH (Updated)",
"monthlyReportsEnabled": true
}'Example Response
{
"id": 101,
"publicId": "6bfec6f6-245a-47ce-843b-157d97d56f88",
"organizationId": 1,
"name": "Customer A GmbH (Updated)",
"email": "contact@customer-a.de",
"notificationPhoneNumber": "+491701234567",
"notificationEmail": "alerts@customer-a.de",
"packageId": 3,
"packageType": "growth",
"status": "active",
"monthlyReportsEnabled": true,
"companyName": "Nordwind ApS",
"emailLanguage": "en",
"customFields": {
"internalReference": "KD-999"
},
"notificationChannels": null,
"notificationTargets": null,
"allowSelfService": null,
"maxSelfServiceUrls": null,
"canEditManaged": false,
"enableEmailAlerts": null,
"enableSmsAlerts": null,
"enableWebhookAlerts": null,
"enableIntegrationAlerts": null,
"enablePostRequestEscalation": null,
"updatedAt": "2026-02-26T19:37:00.000Z"
}packageType and permission overrides: packageType is the raw package key of the customer (the value packageType in the request body resolves to). The permission overrides (allowSelfService, maxSelfServiceUrls, canEditManaged, enableEmailAlerts, enableSmsAlerts, enableWebhookAlerts, enableIntegrationAlerts, enablePostRequestEscalation; null = inherit from the package) are present only for callers that may also write them: an organization admin with an unrestricted customer scope. For a customer-bound token, any user without the admin role (editor, readonly), or a global supporter the fields are left out of the response.
Common Errors
400Invalid Customer identifier400notificationPhoneNumberis not in international format (+and country calling code) or not from the EU/EEA, Switzerland or the UK (data.code:smsCountryNotAllowed). Only a changed number is checked.400Invalid packageId / packageType for this organization (data.code:invalidPackageType)401Unauthorized403Forbidden: your role isreadonly, or you are a global supporter404Customer not found (customerNotFound): the customer does not exist, belongs to another organization or lies outside your customer scope. Until 20.10.2026 the last case answered403.500Failed to update customer