1. E-mail
my.host API
  • Getting started
    • Introduction
    • Base url
    • Authentication
    • Response codes
    • Changelog
  • Domains
    • Domains
      • DNS
        • Zone
          • Get DNS zonefile
          • Import DNS zonefile
        • Dynamic DNS
          • List Dynamic DNS credentials
          • Create Dynamic DNS credential
          • Delete Dynamic DNS credential
          • Reset Dynamic DNS password
        • Get DNS records
        • Update DNS records
        • Update single DNS record
        • Delete single DNS record
        • Add single DNS record
        • Get DNS history
      • List domains
      • Get domain
      • Update domain
      • Cancel domain
      • Cancel domain deletion
      • Get auth code
      • Retry registration or transfer
      • Resend owner verification
    • Contacts
      • List profiles
      • Get profile
      • Create profile
      • Update profile
      • Delete profile
      • Get profile
      • Update profile
    • Nameservers
      • List profiles
      • Get profile
      • Create profile
      • Update profile
      • Delete profile
    • DNS templates
      • List templates
      • Get template
      • Create template
      • Update template
      • Delete template
    • Availability
      • Check domain availability
      • Check availability of several domains
    • Order
      • Order domain
    • Extensions
      • List domain extensions
      • Get domain extension
  • Web hosting
    • Domains
      • List domains
      • Add domain
      • Delete domain
      • Add pointer or alias
      • Delete pointer or alias
      • List subdomains
      • Add subdomain
      • Delete subdomain
      • HTTPS redirect
      • Turn HTTPS redirect on or off
      • List DNS records
      • Add DNS record
      • Delete DNS record
      • Rename domain
      • List redirects
      • Add redirect
      • Delete redirect
      • Hotlink protection
      • Change hotlink protection
    • SSL
      • SSL status of all domains
      • SSL status of a domain
      • Install own certificate
      • Create CSR
      • Request free certificate
    • PHP
      • PHP settings
      • Change PHP settings
    • E-mail
      • List forwarders
        GET
      • Create forwarder
        POST
      • Change forwarder
        PUT
      • Delete forwarder
        DELETE
      • List mailboxes
        GET
      • Create mailbox
        POST
      • Get mailbox
        GET
      • Change mailbox
        PUT
      • Delete mailbox
        DELETE
      • Get autoreply
        GET
      • Set autoreply
        PUT
      • Delete autoreply
        DELETE
      • Get catch-all
        GET
      • Set catch-all
        PUT
      • Get mail settings
        GET
      • Change mail settings
        PUT
    • Databases
      • List databases
      • Create database
      • Delete database
      • Change database password
      • List database users
      • Create database user
      • Delete database user
      • Database privileges
      • Change database privileges
      • List database access hosts
      • Add database access host
      • Delete database access host
    • FTP
      • List FTP accounts
      • Create FTP account
      • Change FTP account
      • Delete FTP account
    • Cron jobs
      • List cron jobs
      • Create cron job
      • Change cron job
      • Delete cron job
    • WordPress
      • List WordPress sites
      • Install WordPress
      • Rescan WordPress sites
      • Get WordPress site
      • Delete WordPress site
      • Purge cache
      • Clone WordPress site
      • List plugins
      • Install plugin
      • Activate or deactivate plugin
      • Delete plugin
      • Push staging to live
      • Change WordPress settings
      • Create staging site
      • List themes
      • Install theme
      • Activate theme
      • Delete theme
      • Update WordPress
    • Reseller
      • List reseller packages
      • Create reseller package
      • Change reseller package
      • Delete reseller package
      • List reseller users
      • Create reseller user
      • Delete reseller user
    • Orders
      • Order a hosting package
      • Quote a hosting package
      • Order extra disk space
      • Reduce extra disk space
      • Quote extra disk space
      • Change package
      • Quote a package change
    • Backups
      • List backups
      • Get backup
      • Restore backup
      • List files in backup
    • Apps
      • List apps
      • Create app
      • Change app
      • Delete app
      • Restart app
      • Install app modules
    • Files
      • List files
      • Delete file or folder
      • Get file content
      • Write file
      • Create folder
      • Move or rename
      • Copy
      • Change permissions
      • Extract archive
      • Create archive
      • Get folder protection
      • Set folder protection
      • Remove protection user
    • Git
      • List Git repositories
      • Create Git repository
      • Get Git repository
      • Change Git repository
      • Delete Git repository
      • Deploy Git repository
      • Fetch Git repository
      • List Git commits
    • List hosting packages
      GET
    • List hosting products
      GET
    • Get hosting package
      GET
    • Cancel hosting package
      DELETE
    • Withdraw cancellation
      PUT
    • Web server logs
      GET
    • Reset account password
      POST
    • SSH access
      GET
    • Turn SSH access on or off
      PUT
    • Usage history
      GET
    • Create login link
      POST
    • Resource usage
      GET
    • Malware found
      GET
    • List SSH keys
      GET
    • Add SSH key
      POST
    • Delete SSH key
      DELETE
    • Redis
      GET
    • Turn Redis on or off
      PUT
  • Virtual Private Servers
    • Backups
      • List backups
      • Create backup
      • Restore backup
      • Delete backup
    • SSH keys
      • List SSH keys
      • Delete SSH key
      • Add SSH key
    • Firewall
      • Get VPS firewall
      • Update VPS firewall
    • VPC
      • Get VPS VPC
      • Create VPS VPC
      • Add VPC subnet
      • Attach VPC subnet
    • Order
      • List VPS products
      • Order VPS
    • Floating IPs
      • List floating IPs
      • Reserve floating IP
      • Attach floating IP
      • Detach floating IP
      • Delete floating IP
    • Volumes
      • List volumes
      • Create volume
      • Attach volume
      • Detach volume
      • Resize volume
      • Delete volume
    • List VPS instances
    • VPS details
    • Update VPS
    • Restart VPS
    • Enable or disable rescue mode
    • Cancel VPS
    • Cancel VPS deletion
    • List available OS images
    • Reinstall VPS
    • Start VPS
    • Stop VPS
    • Power off VPS
    • Reset VPS root password
    • Change VPS hostname
    • Get VPS statistics
    • List VPS licenses
    • Create console link
  • Certificates
    • List certificates
    • Get certificate
    • List certificate products
    • Order certificate
    • Generate CSR
    • Request certificate
  • Orders
    • List orders
    • Get order
    • Update order
  • Affiliate
    • Commissions
      • List affiliate commissions
      • Get affiliate commission
    • Payments
      • List affiliate payments
      • Get affiliate payment
  • Account
    • Profile
      • Get account profile
      • Update account profile
    • Payment methods
      • List payment methods
      • Update default payment method
    • Invoices
      • List invoices
      • Get invoice
      • Download invoice PDF
    • Users
      • List account users
      • Get account user
      • Create account user
      • Update account user
    • Tickets
      • List support tickets
      • Get support ticket
      • Create support ticket
      • Reply to support ticket
  • Tools
    • Get your IP and customer number
  • Tasks
    • Get task
  1. E-mail

Set catch-all

PUT
/hosting/{id}/domains/{domain}/catch-all
Choose what happens to mail for addresses on the domain that do not exist. fail is the default and tells the sender the address does not exist. A catch-all that forwards collects a lot of spam, because spammers guess addresses.
An address on the domain itself must be an existing mailbox or forwarder.
Scope: hosting-email:write.

Request

Authorization
API Key
Add parameter in header
API-key
Example:
API-key: ********************
or
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Header Params

Body Params application/jsonRequired

Example
{
    "action": "fail",
    "address": "info@example.nl"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://mijn.host/api/v2/hosting/12345/domains/example.nl/catch-all' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "fail",
    "address": "info@example.nl"
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "status": 200,
    "status_description": "string",
    "data": {
        "catch_all": {
            "action": "fail",
            "address": "info@example.nl"
        }
    }
}
🟠400Invalid input
🟠403Missing scope
🟠404Not found
🟠409Conflict
🔴502Hosting server unavailable
🟠400Invalid input
🟠400SSL connection is required
🟠401No valid API key set
🟠401API key has expired
🟠401Remote IP address is not found in the API key whitelist
🟠429Rate limit exceeded
🔴500Error
Modified at 2026-11-20 15:12:54
Previous
Get catch-all
Next
Get mail settings
Built with