Customers
Create Customer
Creates a new customer and assigns an organization-defined package via packageType.
POST /api/customers
Authentication
This endpoint requires authentication.
BASE_URL="https://uptimeify.io"
TOKEN="wsm_<your-api-token>"Request Body
{
"name": "Customer Name",
"email": "customer@deinkunde.com",
"packageType": "business", // use the configured packageType or displayName for the organization
"organizationId": 1, // optional (required only for global admins)
"status": "active", // optional, Default: active
"monthlyReportsEnabled": true, // optional, defaults to the package's monthlyReportsDefault
"companyName": "Nordwind ApS",
"emailLanguage": "en", // optional: de, en or da; default: same as the organization
"customFields": { ... } // optional
}Notes:
packageTypecan contain the configured package key or the package display name of the organization. Known aliases such asaquisition_testare normalized automatically.monthlyReportsEnabledis optional. Omit it and the new customer is seeded from the assigned package'smonthlyReportsDefault(see Upsert Package Config); if the organization has no config row for that package, it falls back totrue. An explicit value in the request always wins, the customer field alone decides whether a report is sent.companyNameis optional: the customer's company name, shown as "Company" on the customer page. Empty ornullclears it.emailLanguageis optional:de,enorda, the language of the e-mails and text messages this customer receives (alerts, reports, status pages). Omit it or sendnulland the customer follows the organization's language. Any other value is rejected with400. It can be changed later with Update Customer.- If no configured package matches, the request is rejected with
400 Bad Request. notificationPhoneNumberis optional: the number alert SMS for this customer go to. It must be in international format (+and country calling code) and from the EU/EEA, Switzerland or the UK, otherwise the request is rejected with400 Bad Request(data.code:smsCountryNotAllowed).- For non-global-admin users,
organizationIdis derived from your session/token and must not be overridden. - For global admins,
organizationIdmust be provided explicitly. - Creating a customer is an organization-wide operation: it requires an unrestricted customer scope, not just a role.
readonlyusers,editorusers assigned to specific customers and customer-scoped tokens receive403withdata.code: customerScopedTokenForbidden(see Roles and the customer scope). Organization-wide editors and admins may create customers.
Ownership & permission overrides (optional)
These fields control the customer's managed vs. self-service permissions and channel-type policy. They are organization-write gated: only organization admins (or global admins) can set them. A non-admin caller's values are ignored and the schema defaults apply.
null (or omitting the field) 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). Grants 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.
Response
{
"success": true,
"customer": {
"id": 64,
"publicId": "6d74c32b-a97c-49b9-be3e-2b5e24bed826",
"organizationId": 2,
"name": "Example Customer",
"email": "example@deinkunde.com",
"notificationPhoneNumber": null,
"notificationEmail": null,
"packageId": 7,
"packageType": "essential",
"status": "active",
"allowedCheckCountryCodes": null,
"cancellationDate": null,
"cancelledAt": null,
"customFields": {
"region": "EU",
"planOwner": "Operations"
},
"monthlyReportsEnabled": true,
"companyName": "Nordwind ApS",
"emailLanguage": "en",
"notificationChannels": null,
"notificationTargets": null,
"notificationRules": null,
"smsUsageCurrentMonth": 0,
"createdAt": "2026-04-04T12:27:13.415Z",
"updatedAt": "2026-04-04T12:27:13.415Z"
}
}