Get the welcome message
/org-content/welcome-messageReturns the welcome message for the caller's audience in the caller's language: Internal User for a user of the token organisation, Entrepreneur for a user of an Opportunity Provider, and User for anyone else. An Opportunity Provider shows the message of the organisation that created it. Language is the one on the caller's contact, with no fallback to another. A user who can change the organisation can read another audience with filter[type]; any other reader sending it returns 403 missing_permission. No message for that audience and language returns 404.
variables is resolved (the default), which replaces {{title}}, {{forename}} and {{surname}} with the caller's own, HTML-escaped and in a single pass so a name that looks like a placeholder stays literal, or raw, which returns the stored text. The message is HTML and is returned as stored. Changes nothing. Use PUT /org-content/welcome-message to set the messages.
Query parameters
- One of:
resolved (default) replaces {{title}}, {{forename}} and {{surname}} with the caller's own; raw returns the stored text.
resolved,rawDefault:"resolved" - One of:
Reads the message of another audience instead of the caller's: User, Internal User or Entrepreneur. Needs permission to change the organisation.
User,Internal User,Entrepreneur
Responses
{
"data": {
"type": "Internal User",
"message": "<p>Welcome, Ada.</p>",
"variables": "resolved",
"updated_at": "2026-06-15T10:30:00Z"
}
}Authorization failed. error.code is one of org_disabled,
ip_blocked, missing_scope, scope_disabled, user_disabled.
The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per
problem, or a code documented on the operation.
Examples
curl https://your-org-domain/kong/core/api/v2/org-content/welcome-message\
-H "Authorization: Bearer $HELM_API_KEY"\
-H "Content-Type: application/json"