REST API — Account Wall Name
The account wall-name endpoint lets a subscriber set or clear the name shown on community surfaces — the Supporter Wall and [[benecaster_member_thanks]](/shortcodes/benecaster-member-thanks/) output. The change is self-service: a subscriber can only update their own wall name.
Base URL: /wp-json/benecaster/v1/account/wall-name
POST /benecaster/v1/account/wall-name
Saves the subscriber’s wall name. The value is stored in _benecaster_wall_display_name user meta on the authenticated user’s account.
Authentication: Cookie auth (nonce). The request must be made by the subscriber whose name is being set — no administrator override path exists on this endpoint.
Rate limiting: Requests are tracked under the account_wall_name bucket.
Request body (application/json):
{
"wall_name": "Jane Okafor"
}
| Field | Type | Required | Description |
|---|---|---|---|
wall_name |
string |
Yes | The name to display on community surfaces. Pass an empty string to clear the wall name — the resolution chain will then fall back to first/last name or WordPress display name |
Response — 200 OK:
{
"wall_name": "Jane Okafor"
}
The response echoes the saved value. An empty string in the response means the wall name was cleared successfully.
Error responses:
| Status | When |
|---|---|
400 Bad Request |
wall_name field is missing or not a string |
401 Unauthorized |
No valid authentication credentials |
500 Internal Server Error |
User meta write failed |
Behavior
Setting a name: The submitted value is stored as-is (after sanitisation) in _benecaster_wall_display_name. It appears immediately on the Supporter Wall and in [benecaster_member_thanks] output — no cache flush is required from the caller.
Clearing a name: Passing an empty string deletes the _benecaster_wall_display_name meta entry. benecaster_resolve_wall_display_name() then falls back to first + last name, then to wp_users.display_name.
No effect on the WordPress account: This endpoint writes only to _benecaster_wall_display_name. It does not touch wp_users.display_name or any other WordPress user field.
The field is show-gated on the account page. The wall name input only appears in the [benecaster_account] shortcode when the Supporter Wall is enabled on at least one of the subscriber’s active shows. The endpoint itself has no show gate — it will accept a write regardless of Supporter Wall status.
Renamed from POST /account/display-name
This endpoint replaces POST /benecaster/v1/account/display-name, which was removed in the 2026-08-15 Wall Name rework. The old endpoint wrote to wp_users.display_name; the new endpoint writes to _benecaster_wall_display_name instead. Any code calling the old path must be updated to the new URL and the wall_name field name.
The internal rate-limit bucket was also renamed from account_display_name to account_wall_name.
Related
benecaster_resolve_wall_display_name()— reads the value this endpoint writes- Supporter Wall — the primary surface that displays wall names
- The Subscriber Account Page — the UI where subscribers call this endpoint