Skip to main content
Agency API endpoints were added in v2.8.0.
Base path: /wp-json/wp-manager-pro/v1/agency All endpoints require X-WP-Nonce header with a wp_rest nonce and the manage_options capability.

​
GET /agency/mail-settings

Returns the mail interceptor configuration (whether Dev Mode is enabled). 
curl https://example.com/wp-json/wp-manager-pro/v1/agency/mail-settings \
  -H "X-WP-Nonce: YOUR_NONCE"

​
Response

​
dev_mode
boolean
Whether Dev Mode is active (intercepting all outgoing emails).
​
log
array
Array of captured email log entries.

​
GET /agency/mail-log

Returns paginated mail interceptor log entries. 
curl https://example.com/wp-json/wp-manager-pro/v1/agency/mail-log \
  -H "X-WP-Nonce: YOUR_NONCE"

​
Response

Returns an array of log entry objects (same structure as the log field above).

​
DELETE /agency/mail-log/clear

Clears all mail interceptor log entries. 
curl -X DELETE https://example.com/wp-json/wp-manager-pro/v1/agency/mail-log/clear \
  -H "X-WP-Nonce: YOUR_NONCE"

​
Response

​
success
boolean
Always true on success.

​
POST /agency/mail-resend

Resends a logged email immediately, regardless of Dev Mode state. 
curl -X POST https://example.com/wp-json/wp-manager-pro/v1/agency/mail-resend \
  -H "X-WP-Nonce: YOUR_NONCE" \
  -H "Content-Type: application/json" \
  -d '{"id": 5}'

​
Parameters

​
id
integer
required
ID of the mail log entry to resend.

​
Response

​
success
boolean
Always true on success.

​
GET /agency/login-page

Returns the current white-label login page configuration. 
curl https://example.com/wp-json/wp-manager-pro/v1/agency/login-page \
  -H "X-WP-Nonce: YOUR_NONCE"

​
Response

​
enabled
boolean
Whether the custom login page is active.
​
logo_url
string
URL of the custom logo image.
​
bg_color
string
Hex background color.
​
bg_image
string
URL of the background image.
​
button_color
string
Hex color for the login button.
​
heading_text
string
Custom heading shown above the login form.
​
footer_text
string
Custom footer text.
​
privacy_url
string
URL for the Privacy policy link.
​
terms_url
string
URL for the Terms of service link.

​
POST /agency/login-page

Saves white-label login page settings. Pass only the fields you want to update. 
curl -X POST https://example.com/wp-json/wp-manager-pro/v1/agency/login-page \
  -H "X-WP-Nonce: YOUR_NONCE" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "heading_text": "Client Portal", "button_color": "#94cb04"}'

​
Parameters

​
enabled
boolean
Whether to activate the custom login page.
​
logo_url
string
Logo image URL.
​
bg_color
string
Hex background color.
​
bg_image
string
Background image URL.
​
button_color
string
Hex color for the login button.
​
heading_text
string
Heading text above the form.
​
footer_text
string
Footer text below the form.
​
privacy_url
string
Privacy policy link URL.
​
terms_url
string
Terms of service link URL.

​
Response

​
success
boolean
Always true on success.

​
GET /agency/admin-customiser

Returns the current admin menu and dashboard widget visibility settings. 
curl https://example.com/wp-json/wp-manager-pro/v1/agency/admin-customiser \
  -H "X-WP-Nonce: YOUR_NONCE"

​
Response

​
hidden_menus
array
Array of admin menu slugs hidden for non-administrator roles.
​
hidden_widgets
array
Array of dashboard widget IDs hidden for non-administrator roles.
​
available_menus
array
All available admin menu items as {slug, title} objects.
​
available_widgets
array
All available dashboard widgets as {id, title} objects.

​
POST /agency/admin-customiser

Saves admin UI customisation settings. 
curl -X POST https://example.com/wp-json/wp-manager-pro/v1/agency/admin-customiser \
  -H "X-WP-Nonce: YOUR_NONCE" \
  -H "Content-Type: application/json" \
  -d '{"hidden_menus": ["edit.php?post_type=page", "tools.php"], "hidden_widgets": ["dashboard_recent_comments"]}'

​
Parameters

​
hidden_menus
array
Array of admin menu slugs to hide from non-administrator roles.
​
hidden_widgets
array
Array of dashboard widget IDs to hide from non-administrator roles.

​
Response

​
success
boolean
Always true on success.

​
GET /agency/report

Generates and returns the full client health report data. 
curl https://example.com/wp-json/wp-manager-pro/v1/agency/report \
  -H "X-WP-Nonce: YOUR_NONCE"

​
Response

​
health_score
integer
0–100 health score.
​
site_name
string
WordPress site name.
​
site_url
string
Site home URL.
​
generated_at
string
ISO 8601 generation timestamp.
​
wp_version
string
WordPress version.
​
php_version
string
PHP version.
​
db_size
string
Total database size (human-readable).
​
ssl
boolean
Whether the site is served over HTTPS.
​
wp_debug
boolean
Whether WP_DEBUG is enabled.
​
pending_updates
integer
Number of pending plugin/theme/core updates.
​
last_backup
string|null
Date of the most recent WP Manager Pro backup, or null.
​
active_plugins
array
Array of active plugin objects with name, version, author, and update_available.
​
active_theme
object
Active theme details: name, version, author, update_available.

​
GET /agency/coming-soon

Returns the coming soon page configuration. 
curl https://example.com/wp-json/wp-manager-pro/v1/agency/coming-soon \
  -H "X-WP-Nonce: YOUR_NONCE"

​
Response

​
active
boolean
Whether coming soon mode is active.
​
heading
string
Main heading text.
​
message
string
Supporting message text.
​
launch_date
string
ISO 8601 launch date for the countdown timer.
​
logo_url
string
Logo image URL.
​
bg_image
string
Background image URL.
​
bg_color
string
Hex background color.
​
accent_color
string
Hex accent color for countdown tiles.
​
email_capture
boolean
Whether the email capture form is active.
​
captured_emails
array
Array of captured subscriber email addresses.

​
POST /agency/coming-soon

Saves coming soon page settings. Also updates the active state. 
curl -X POST https://example.com/wp-json/wp-manager-pro/v1/agency/coming-soon \
  -H "X-WP-Nonce: YOUR_NONCE" \
  -H "Content-Type: application/json" \
  -d '{"active": true, "heading": "Coming Soon", "accent_color": "#94cb04", "email_capture": true}'

​
Parameters

​
active
boolean
Whether to enable coming soon mode.
​
heading
string
Main heading text.
​
message
string
Supporting message.
​
launch_date
string
ISO 8601 launch date.
​
logo_url
string
Logo image URL.
​
bg_image
string
Background image URL.
​
bg_color
string
Hex background color.
​
accent_color
string
Hex accent color.
​
email_capture
boolean
Enable/disable email capture form.

​
Response

​
success
boolean
Always true on success.

​
DELETE /agency/coming-soon/emails/clear

Clears all captured coming soon subscriber email addresses.
This action permanently deletes all captured email addresses. Export them first if needed.
curl -X DELETE https://example.com/wp-json/wp-manager-pro/v1/agency/coming-soon/emails/clear \
  -H "X-WP-Nonce: YOUR_NONCE"

​
Response

​
success
boolean
Always true on success.

Build docs developers (and LLMs) love

Get started for freeTalk to us