Skip to main content
PATCH
Update platform settings
This endpoint changes the settings of your white label platform. Send only the sections, and the keys inside them, that you want to change: everything you leave out stays as it is. The response returns all your settings after the change, in the same format as Get platform settings.
This endpoint is available to the account owner (with an active plan) and to team members with Settings Access. Changing the checkout section also requires Billing Access, which the owner always has. Without the required access the request returns a 403 Forbidden error and nothing is saved.

Request Body

object
The welcome email sent to new users. Every key takes a string, or null to use the default text. You can use these placeholders in every key except contact_email: {user_name} (the new user’s name), {tenant_name} (your platform name) and {tenant_domain} (your platform domain).
object
Which emails your users receive. Each email takes true (sent) or false (not sent). Password reset emails are always sent.
object
Code added to your platform’s pages, for example a live chat or analytics snippet. Each key takes a string of up to 65,535 characters, or null to remove the script.
object
What your users see on your platform. A list you send replaces the current list; send [] to clear it. A value sent twice is saved once, and a list cannot have more items than it has possible values.
object
Your webhooks
object
Your checkout settings. Changing them requires Billing Access.

Response

string
Success message
object
All your settings after the change, in the same format as Get platform settings. The checkout section is only included if you have Billing Access.

Partial updates

  • Sections you do not send stay unchanged, and so do the keys you leave out of a section you send.
  • A list you send, such as hide_pages, replaces the whole list. Send [] to clear it.
  • An unknown top-level field returns 422 with “The X field is not supported.”, and an unknown key inside a section returns 422 with “The X field must be an object with only the supported keys.”. In both cases nothing is saved, not even the valid parts of the request.
  • Leading and trailing spaces and line breaks are removed from text values, scripts included. An empty string is saved as null.
  • Send only the keys you want to change. A value you read earlier and send back unchanged is saved again, trimmed.

Pages you can hide

Features you can hide

All pages, and all features except hide_auto_generated_plan_features and hide_platform_tour, can also be set for a single user with Update user settings.

Countries you can hide

Signup webhook

Each time a new user account is created on your platform, for example when someone signs up, the platform sends a POST request with this JSON body to user_signup_webhook_url:

Rate limit

The platform settings, default limits, user settings and plan endpoints share a limit of 60 requests per minute for each account. Above it they return 429, and the Retry-After response header tells you how many seconds to wait.

Example