Skip to content
Changelog

Report a bug

Hostinger integration: operations for AI agents

Hostinger connects to Type.com as an integration. This page lists the 432 operations documented for Claude and Codex in Type.com: 178 read, 147 write, 107 destructive.

About Hostinger

Hostinger vendor API references, subject to vendor permissions and account availability.

Categories: Developer Tools & IT

How to connect Hostinger to Type.com

Access
Organization connection: one shared account for the workspace.
MCP
Selected AI media-generation operations are not available through Type’s MCP server. Other operations remain available through MCP, subject to your connection’s permissions. These MCP restrictions do not apply within Type.

To add the connection, follow the steps in Space connections.

Documented operations

432 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

432 operations listed.

Agency Hosting: Datacenters

  • Read

    List available datacenters

    Lists the datacenters available for provisioning a new website on the given Agency Plan hosting order. Each datacenter includes a `pinger_url` you can ping from the client to measure round-trip latency; comparing the results across datacenters lets you pick the nearest one (lowest ping) before choosing its `code` as the `datacenter_code` when creating a website setup.

    GET /api/agency-hosting/v1/orders/{order_id}/datacenters

Agency Hosting: Domains

  • Read

    List domains

    Returns a paginated list of domains associated with Agency Plan websites accessible to the authenticated client. Use the website_uuids filter to narrow results to specific websites.

    GET /api/agency-hosting/v1/domains

  • Write

    Change website domain

    Changes the primary domain for an Agency Plan website. Provide the current domain in the path and the new domain in the request body. Set domain to null to revert to the temporary domain.

    PUT /api/agency-hosting/v1/websites/{website_uid}/domains/{from_domain}

  • Write

    Link domain to website

    Links a domain to the specified Agency Plan website so it can serve traffic for that domain.

    POST /api/agency-hosting/v1/websites/{website_uid}/domains

  • Destructive

    Unlink domain from website

    Unlinks a domain from the specified Agency Plan website. The website stops serving traffic on this domain immediately. Website files and database are preserved, and any other linked domains remain accessible. If this is the only domain on the website, unlinking leaves the website without an accessible domain.

    DELETE /api/agency-hosting/v1/websites/{website_uid}/domains/{domain}

Agency Hosting: Files

  • Write

    Generate upload URL

    Generate a file browser upload URL with authentication credentials for uploading files to an Agency Plan website's file storage. Returns `url`, `auth_key` and `rest_auth_key`. Use these to upload a file to the website's file storage via the TUS resumable upload protocol (TUS 1.0.0). Send `X-Auth: {auth_key}` and `X-Auth-Rest: {rest_auth_key}` headers on every request below. 1. Create the upload: `POST` to `{url}/{relative_file_path}?override=true` with headers `upload-length: {file size in bytes}` and `upload-offset: 0`. Expect `201 Created`. 2. Upload the file: send the file bytes to the same location (any TUS 1.0.0 client, or `PATCH` requests with an `upload-offset` header tracking progress) until complete. `relative_file_path` is the destination path inside the website's file storage, e.g. `app.zip`. Instead of a TUS client, plain `curl` also works: ``` FILE=app.zip SIZE=$(stat -f%z "$FILE") # stat -c%s on Linux curl -i -X POST "{url}/${FILE}?override=true" \ -H "X-Auth: {auth_key}" \ -H "X-Auth-Rest: {rest_auth_key}" \ -H "Tus-Resumable: 1.0.0" \ -H "Upload-Length: ${SIZE}" \ -H "Upload-Offset: 0" # -> 201 Created curl -i -X PATCH "{url}/${FILE}?override=true" \ -H "X-Auth: {auth_key}" \ -H "X-Auth-Rest: {rest_auth_key}" \ -H "Tus-Resumable: 1.0.0" \ -H "Content-Type: application/offset+octet-stream" \ -H "Upload-Offset: 0" \ --data-binary "@${FILE}" # -> 204 No Content, Upload-Offset response header equals SIZE when done ```

    POST /api/agency-hosting/v1/websites/{website_uid}/files/upload-urls

  • Destructive

    Import website from archive

    Imports an Agency Plan website from an already-uploaded archive. Upload the archive to the website's root directory via file browser first, then provide its filename in this request. Website contents are overwritten by the archive contents. Supported archive types: .zip, .tar, .tar.gz, .tgz.

    POST /api/agency-hosting/v1/websites/{website_uid}/files/import-archive

Agency Hosting: Metrics

  • Read

    List Agency Plan order disk usage metrics

    Returns aggregated disk and inode usage for the Agency Plan order over the selected time frame, plus the plan quotas. Figures cover the whole order account. Values may be up to one hour stale. CPU, memory, and process usage are on the resource-usage-metrics endpoint.

    GET /api/agency-hosting/v1/orders/{order_id}/disk-usage-metrics

  • Read

    List order resource usage metrics

    Returns aggregated CPU, memory, and process usage for the Agency Plan order over the selected time frame, plus the plan quotas and a per-website breakdown. Each website is identified by uid. Suspended and deleted websites are excluded from both the order totals and the per-website breakdown. Values may be up to one hour stale. Disk and inode usage are on the disk-usage-metrics endpoint.

    GET /api/agency-hosting/v1/orders/{order_id}/resource-usage-metrics

Agency Hosting: Orders

  • Read

    List orders

    Returns a paginated list of Agency Plan orders accessible to the authenticated client.

    GET /api/agency-hosting/v1/orders

Agency Hosting: PHP

  • Read

    List PHP extensions for a website

    Lists every PHP extension available to an Agency Plan website and whether it is currently enabled.

    GET /api/agency-hosting/v1/websites/{website_uid}/php-settings/extensions

  • Read

    List PHP options for a website

    Lists the php.ini directives that can be configured for an Agency Plan website, each with its default, the value currently in effect, and the values it accepts.

    GET /api/agency-hosting/v1/websites/{website_uid}/php-settings/options

  • Read

    List available PHP versions for an order

    Lists the PHP versions available to websites created under an Agency Plan order, determined by the server the order is hosted on. Use this before creating a website; for a website that already exists, call the website-scoped versions endpoint instead.

    GET /api/agency-hosting/v1/orders/{order_id}/websites/php-settings/versions

  • Read

    List available PHP versions for a website

    Lists the PHP versions an Agency Plan website can be switched to. The version the website is currently running is returned as settings.php.version by the website details endpoint.

    GET /api/agency-hosting/v1/websites/{website_uid}/php-settings/versions

  • Write

    Update website PHP version

    Switches an Agency Plan website to a different PHP version. Call the available versions endpoint first to see which versions can be selected. The website restarts on the new version, so requests served during the switch may fail and code that is incompatible with the target version will break.

    PATCH /api/agency-hosting/v1/websites/{website_uid}/php-settings/version

  • Destructive

    Replace website PHP extensions

    Replaces the set of PHP extensions enabled on an Agency Plan website with the ones provided. Any toggleable extension not in the request is disabled, so call the extensions endpoint first and send the full desired set. Extensions compiled into PHP, reported with the "built-in" state, are always active and are unaffected.

    PUT /api/agency-hosting/v1/websites/{website_uid}/php-settings/extensions

  • Destructive

    Replace website PHP options

    Replaces the custom php.ini values on an Agency Plan website with the ones provided. Any option not in the request is reset to its default, so call the options endpoint first and send the full desired set. Sending an empty array resets every option to its default.

    PUT /api/agency-hosting/v1/websites/{website_uid}/php-settings/options

Agency Hosting: Website Setups

  • Read

    Get website setup status

    Returns the current status of an Agency Plan website setup started via the setups endpoint. Poll this endpoint using the `setup_uuid` returned from the provisioning request until `status` becomes `completed`, at which point `website_uid` identifies the new website.

    GET /api/agency-hosting/v1/orders/{order_id}/websites/setups/{setup_uuid}

  • Write

    Create a new website

    Provisions a new website on one of your Agency Plan hosting orders. Choose the datacenter, stack (`flavor`), and PHP version for the site. Optionally attach your own `domain` — omit it, set it to `null`, or leave it unavailable and a free `*.hostingersite.com` subdomain is generated instead — and/or install WordPress by supplying the `wordpress` details (admin account, site title, and language). Common setups: - **Plain PHP site**: `flavor` set to `php-fpm`, with `settings.php.version`; omit `wordpress` and `type`. - **WordPress site**: `flavor` set to the desired WordPress version (e.g. `wp-7.0`), plus the `wordpress` block (admin account, title, language). - **Static/Node.js frontend app**: `flavor` set to `php-fpm` and `type` set to `node-static`. Provisioning runs in the background, so the response returns immediately with a setup UUID that identifies the job. The new website becomes reachable once provisioning finishes.

    POST /api/agency-hosting/v1/orders/{order_id}/websites/setups

Agency Hosting: SSL

  • Read

    Get website SSL status

    Returns the SSL state of one domain of an Agency Plan website: the certificate `status`, whether the certificate was uploaded by the customer, and when it stops being valid. `installing` means a certificate setup is running or retrying; the `ssl_setup` entry of `List website processes` shows the same progress. `active` means a valid certificate is in place: uploaded by the customer, issued by the platform, or a lifetime certificate bought for the domain. `failed` means the last setup gave up and no valid certificate is in place. `expired` means the certificate has run out. `not_installed` means the domain has no certificate and no setup process. Returns 404 when the website or the domain does not exist.

    GET /api/agency-hosting/v1/websites/{website_uid}/domains/{domain}/ssl/status

  • Write

    Install website SSL

    Starts a Let's Encrypt certificate setup for the domain and returns at once; the setup runs in the background. `Get website SSL status` reports `installing` while it runs, then `active` or `failed`; the `ssl_setup` entry of `List website processes` shows the same progress. Returns 422 when the domain already has a platform certificate that is not expired, when a certificate process is recorded for the domain (a failed setup counts until it is cleaned up), or when the domain hit its limit of three setups per seven days. Returns 429 when the same domain was requested less than a minute ago, 403 when the website is suspended or locked, and 404 when the website or the domain does not exist.

    POST /api/agency-hosting/v1/websites/{website_uid}/domains/{domain}/ssl/setup

  • Destructive

    Reinstall website SSL

    Replaces the Let's Encrypt certificate of the domain: the current platform certificate, when one is recorded, is revoked and removed, then a new setup starts in the background. Returns at once; `Get website SSL status` reports `installing` while it runs, then `active` or `failed`. Returns 422 for free subdomains, when a certificate process is recorded for the domain (a failed setup counts until it is cleaned up), or when the domain hit its limit of three setups per seven days. Returns 429 when the same domain was requested less than a minute ago, and 403 when the website is suspended or locked, and 404 when the website or the domain does not exist.

    POST /api/agency-hosting/v1/websites/{website_uid}/domains/{domain}/ssl/reinstall

  • Destructive

    Uninstall website SSL

    Removes the platform-issued Let's Encrypt certificate of the domain: the certificate is revoked and deleted before the response, so the domain is no longer served with a platform certificate until a new setup completes. Also succeeds when the domain has no platform certificate to remove. Uploaded (custom) certificates are not affected. Returns 422 when a certificate process is recorded for the domain (a failed setup counts until it is cleaned up), 429 when the same domain was requested less than a minute ago, and 403 when the website is suspended or locked, and 404 when the website or the domain does not exist.

    DELETE /api/agency-hosting/v1/websites/{website_uid}/domains/{domain}/ssl

Agency Hosting: Websites

  • Read

    Get website details

    Retrieves detailed information about a specific Agency Plan website, including configuration, status, metadata, hosting plan details, and resource quotas.

    GET /api/agency-hosting/v1/websites/{website_uid}

  • Read

    List Agency Plan websites

    Retrieve a paginated list of Agency Plan websites (H5G, Builder, and Horizons) accessible to the authenticated client. This endpoint returns websites from your hosting accounts as well as websites from other client hosting accounts that have shared access with you. The response shape differs per platform — see the `platform` field on each item. Use `website_types` to list only websites of a given detected type, e.g. only WordPress websites (`website_types=wordpress`) or only Node.js websites (`website_types=nodejs`). Combine with `order_ids`, `states`, or `domain` for more targeted results.

    GET /api/agency-hosting/v1/websites

  • Read

    List website processes

    Lists active and recently completed asynchronous processes for an Agency Plan website. Each process has a unique ID (for tracking), a type, and a status (running, completed, failed). Poll this endpoint after initiating async operations (SSL setup, backups, cloning) to track progress.

    GET /api/agency-hosting/v1/websites/{website_uid}/processes

  • Destructive

    Build website NodeJS assets

    Builds and deploys a Node.js application for an Agency Plan website from an already-uploaded archive. Upload the archive to file browser first, then provide its relative path from document root in this request. Website contents are overwritten by the build result, which is deployed to public_html.

    POST /api/agency-hosting/v1/websites/{website_uid}/build-assets

  • Destructive

    Delete website

    Permanently deletes an Agency Plan website. Deletion is processed asynchronously: the website is immediately transitioned to a deleting state and the underlying server resources are removed in the background.

    DELETE /api/agency-hosting/v1/websites/{website_uid}

Agency Hosting: Cache

  • Destructive

    Clear website cache

    Clears cache for all domains associated with an Agency Plan website, including its preview domain. This operation clears all cache types for the website.

    DELETE /api/agency-hosting/v1/websites/{website_uid}/cache

Agency Hosting: Cron Jobs

  • Read

    List website cron jobs

    Returns a paginated list of cron jobs configured for an Agency Plan website. Each entry includes the schedule expression and the command executed on that schedule.

    GET /api/agency-hosting/v1/websites/{website_uid}/cron-jobs

  • Write

    Create website cron job

    Creates a cron job for an Agency Plan website from a schedule expression and a command. Returns the created cron job, including its uuid, which is required to delete the cron job.

    POST /api/agency-hosting/v1/websites/{website_uid}/cron-jobs

  • Destructive

    Delete website cron job

    Permanently deletes the cron job identified by its uuid from an Agency Plan website. The operation is idempotent: deleting a cron job that does not exist succeeds without error.

    DELETE /api/agency-hosting/v1/websites/{website_uid}/cron-jobs/{uuid}

Agency Hosting: Databases

  • Read

    List website databases

    Returns a paginated list of MySQL databases created for an Agency Plan website. Each entry includes the database's non-system users.

    GET /api/agency-hosting/v1/websites/{website_uid}/databases

  • Write

    Create website database

    Creates a MySQL database with a dedicated user for an Agency Plan website. The database name, username, and password must all be provided by the caller.

    POST /api/agency-hosting/v1/websites/{website_uid}/databases

  • Write

    Create website database user

    Creates a user for an existing database on an Agency Plan website. Each database supports a single non-system user; creating a user for a database that already has one fails.

    POST /api/agency-hosting/v1/websites/{website_uid}/databases/{database_name}/users

  • Destructive

    Delete website database

    Permanently deletes a MySQL database and all its data from an Agency Plan website, including its users. The operation is idempotent: deleting a database that does not exist succeeds without error.

    DELETE /api/agency-hosting/v1/websites/{website_uid}/databases/{database_name}

  • Destructive

    Delete website database user

    Permanently deletes a database user from an Agency Plan website database, revoking all access it had. The operation is idempotent: deleting a user that does not exist succeeds without error.

    DELETE /api/agency-hosting/v1/websites/{website_uid}/databases/{database_name}/users/{database_user_name}

Agency Hosting: WordPress

  • Read

    Get WordPress settings

    Returns the current WordPress settings for an Agency Plan website: installed core version, LiteSpeed Cache plugin status, object cache status, and maintenance mode status.

    GET /api/agency-hosting/v1/websites/{website_uid}/wordpress/settings

  • Read

    List available WordPress versions

    Lists the WordPress core versions available for installation on an Agency Plan website.

    GET /api/agency-hosting/v1/websites/{website_uid}/wordpress/settings/versions

  • Write

    Change WordPress version

    Changes the installed WordPress core version on an Agency Plan website to one of the versions available for installation.

    PATCH /api/agency-hosting/v1/websites/{website_uid}/wordpress/settings/version

Agent Readiness: Checks

  • Read

    List checks

    List every check an agent readiness scan runs, with its name, category and weight.\n Use it to show the human-readable name of each `check_id` in a scan's results.

    GET /api/agent-readiness/v1/checks

Agent Readiness: Scans

  • Read

    Get agent readiness scan

    Get the latest agent readiness scan of a website.\n Scans started with the `Run agent readiness scan` operation are asynchronous. While the status is `pending`, the result fields are null; wait a few seconds and call this operation again until the status is `completed` or `failed`. A `failed` scan is not retried; run the scan again.\n A completed scan has a 0-100 score, a letter grade, a score per category, and the result of every check with the evidence found and how to fix it. Check names are listed by the `List checks` operation.\n Returns 404 when the domain has never been scanned; use the `Run agent readiness scan` operation first.

    GET /api/agent-readiness/v1/scans/{domain}

  • Write

    Run agent readiness scan

    Start a scan of how ready a public website is for AI agents to discover, read and act on.\n Scanning is asynchronous: this operation only starts the scan, and the returned scan is usually `pending` with no results yet. To get the results, poll the `Get agent readiness scan` operation with the same domain every few seconds until its status is `completed` or `failed`. The scan itself is limited to 60 seconds, plus any time it waits in the queue. A `failed` scan is not retried; run this operation again.\n Starting a scan for a domain that already has a pending scan from the last 5 minutes returns that scan instead of starting a new one.

    POST /api/agent-readiness/v1/scans

Billing: Catalog

  • Read

    Get catalog item list

    Retrieve catalog items available for order. Prices in catalog items is displayed as cents (without floating point), e.g: float `17.99` is displayed as integer `1799`. Use this endpoint to view available services and pricing before placing orders.

    GET /api/billing/v1/catalog

Billing: Orders

  • Write

    Create purchase order

    Create a purchase order for any Hostinger product. This unified endpoint places an order for one or more catalog items and works across all Hostinger products, leveraging the existing billing infrastructure. Use the [catalog endpoint](#tag/billing-catalog) to look up the `item_id` values available for purchase. If no payment method is provided, your default payment method will be used automatically. If the response is `202 Accepted`, the payment is still being processed and the order will complete asynchronously once the payment is confirmed. This endpoint only places the order. Product-specific provisioning (e.g. VPS setup or domain registration) is not performed here — once the order completes, use the relevant product endpoints or [hPanel](https://hpanel.hostinger.com/) to finalize setup. Use this endpoint to purchase any product available in the catalog.

    POST /api/billing/v1/orders

Billing: Payment methods

  • Read

    Get payment method list

    Retrieve available payment methods that can be used for placing new orders. If you want to add new payment method, please use [hPanel](https://hpanel.hostinger.com/billing/payment-methods). Use this endpoint to view available payment options before creating orders.

    GET /api/billing/v1/payment-methods

  • Write

    Set default payment method

    Set the default payment method for your account. Use this endpoint to configure the primary payment method for future orders.

    POST /api/billing/v1/payment-methods/{paymentMethodId}

  • Destructive

    Delete payment method

    Delete a payment method from your account. Use this endpoint to remove unused payment methods from user accounts.

    DELETE /api/billing/v1/payment-methods/{paymentMethodId}

Billing: Subscriptions

  • Read

    Get subscription list

    Retrieve a list of all subscriptions associated with your account. Use this endpoint to monitor active services and billing status.

    GET /api/billing/v1/subscriptions

  • Write

    Enable auto-renewal

    Enable auto-renewal for a subscription. Use this endpoint when enable auto-renewal for a subscription.

    PATCH /api/billing/v1/subscriptions/{subscriptionId}/auto-renewal/enable

  • Write

    Renew subscription

    Create a renewal order for an existing Hostinger subscription. This endpoint places a renewal order for a single subscription, leveraging the existing billing infrastructure. Use the [subscriptions endpoint](#tag/billing-subscriptions) to look up the `subscriptionId` values available for renewal. If no payment method is provided, your default payment method will be used automatically. If the response is `202 Accepted`, the payment is still being processed and the renewal will complete asynchronously once the payment is confirmed. Use this endpoint to renew any subscription available in your account.

    POST /api/billing/v1/subscriptions/{subscriptionId}/renew

  • Destructive

    Disable auto-renewal

    Disable auto-renewal for a subscription. Use this endpoint when disable auto-renewal for a subscription.

    DELETE /api/billing/v1/subscriptions/{subscriptionId}/auto-renewal/disable

DNS: Snapshot

  • Read

    Get DNS snapshot

    Retrieve particular DNS snapshot with contents of DNS zone records. Use this endpoint to view historical DNS configurations for domains.

    GET /api/dns/v1/snapshots/{domain}/{snapshotId}

  • Read

    Get DNS snapshot list

    Retrieve DNS snapshots for a domain. Use this endpoint to view available DNS backup points for restoration.

    GET /api/dns/v1/snapshots/{domain}

  • Write

    Restore DNS snapshot

    Restore DNS zone to the selected snapshot. Use this endpoint to revert domain DNS to a previous configuration.

    POST /api/dns/v1/snapshots/{domain}/{snapshotId}/restore

DNS: Zone

  • Read

    Get DNS records

    Retrieve DNS zone records for a specific domain. Use this endpoint to view current DNS configuration for domain management.

    GET /api/dns/v1/zones/{domain}

  • Read

    Validate DNS records

    Validate DNS records prior to update for the selected domain. If the validation is successful, the response will contain `200 Success` code. If there is validation error, the response will fail with `422 Validation error` code. Use this endpoint to verify DNS record validity before applying changes.

    POST /api/dns/v1/zones/{domain}/validate

  • Write

    Reset DNS records

    Reset DNS zone to the default records. Use this endpoint to restore domain DNS to original configuration.

    POST /api/dns/v1/zones/{domain}/reset

  • Destructive

    Update DNS records

    Update DNS records for the selected domain. Using `overwrite = true` will replace existing records with the provided ones. Otherwise existing records will be updated and new records will be added. Use this endpoint to modify domain DNS configuration.

    PUT /api/dns/v1/zones/{domain}

  • Destructive

    Delete DNS records

    Delete DNS records for the selected domain. To filter which records to delete, add the `name` of the record and `type` to the filter. Multiple filters can be provided with single request. If you have multiple records with the same name and type, and you want to delete only part of them, refer to the `Update zone records` endpoint. Use this endpoint to remove specific DNS records from domains.

    DELETE /api/dns/v1/zones/{domain}

Domain Access Verifier: Verifications

  • Read

    Get domain verifications

    Retrieve a list of pending and completed domain verifications.

    GET /api/v2/direct/verifications/active

Domains: Availability

  • Read

    Check domain availability

    Check availability of domain names across multiple TLDs. Multiple TLDs can be checked at once. If you want alternative domains with response, provide only one TLD and set `with_alternatives` to `true`. TLDs should be provided without leading dot (e.g. `com`, `net`, `org`). Endpoint has rate limit of 90 requests per minute. Use this endpoint to verify domain availability before purchase.

    POST /api/domains/v1/availability

  • Write

    Suggest domain names from a description

    Suggest available domain names based on a free-text description of your project. Suggestions are generated by an AI model, so they differ between calls. Endpoint has rate limit of 90 requests per minute. Use this endpoint to find a domain name when you only know what the website is about.

    POST /api/domains/v1/availability/alternatives-from-description

  • Write

    Suggest domain names from a domain

    Suggest available domain names based on a domain name you already have in mind. Suggestions are generated by an AI model, so they differ between calls. Endpoint has rate limit of 90 requests per minute. Use this endpoint when the domain you wanted is taken and you need close alternatives.

    POST /api/domains/v1/availability/alternatives-from-domain

Domains: Forwarding

  • Read

    Get domain forwarding

    Retrieve domain forwarding data. Use this endpoint to view current redirect configuration for domains.

    GET /api/domains/v1/forwarding/{domain}

  • Write

    Update domain forwarding

    Update domain forwarding configuration. Use this endpoint to modify existing redirect configuration for domains.

    PUT /api/domains/v1/forwarding/{domain}

  • Write

    Create domain forwarding

    Create domain forwarding configuration. Use this endpoint to set up domain redirects to other URLs.

    POST /api/domains/v1/forwarding

  • Destructive

    Delete domain forwarding

    Delete domain forwarding data. Use this endpoint to remove redirect configuration from domains.

    DELETE /api/domains/v1/forwarding/{domain}

Domains: WHOIS

  • Read

    Get pending IRTP verification

    Retrieve a pending IRTP verification for a domain. Both the old and new registrant must confirm it before the WHOIS change takes effect. Use this endpoint to check the status of a WHOIS change awaiting registrant confirmation.

    GET /api/domains/v1/irtp/{domain}

  • Read

    Get WHOIS profile

    Retrieve a WHOIS contact profile. Use this endpoint to view domain registration contact information.

    GET /api/domains/v1/whois/{whoisId}

  • Read

    Get WHOIS profile list

    Retrieve WHOIS contact profiles. Use this endpoint to view available contact profiles for domain registration.

    GET /api/domains/v1/whois

  • Read

    Get WHOIS profile usage

    Retrieve domain list where provided WHOIS contact profile is used. Use this endpoint to view which domains use specific contact profiles.

    GET /api/domains/v1/whois/{whoisId}/usage

  • Write

    Change WHOIS profile for domain

    Change WHOIS contact profile for a domain. Repoints the given contact roles to a new WHOIS profile and submits the change to the registry. The profile currently assigned to those roles is resolved automatically; the request fails if the given roles are not all on the same profile today. Changing transfer sensitive fields on the owner contact starts an IRTP verification. The change is processed asynchronously. Use this endpoint to move a registered domain onto different contact information.

    PUT /api/domains/v1/whois/change

  • Write

    Set WHOIS profile as default

    Set WHOIS contact profile as default. The default profile is pre-selected for the TLD it belongs to when registering new domains. Use this endpoint to avoid picking contact information for every registration.

    PUT /api/domains/v1/whois/default/{whoisId}

  • Write

    Create WHOIS profile

    Create WHOIS contact profile. Use this endpoint to add new contact information for domain registration.

    POST /api/domains/v1/whois

  • Destructive

    Cancel pending IRTP verification

    Cancel a pending IRTP verification. Use this endpoint to back out of a WHOIS change that is stuck waiting on registrant confirmation, for example when the confirmation email cannot be received, without waiting out the 5-day expiry.

    DELETE /api/domains/v1/irtp/{domain}

  • Destructive

    Unset default WHOIS profile

    Unset WHOIS contact profile as default. The profile itself is kept, it is only no longer pre-selected for its TLD. Use this endpoint to stop reusing contact information for new registrations.

    DELETE /api/domains/v1/whois/default/{whoisId}

  • Destructive

    Delete WHOIS profile

    Delete WHOIS contact profile. Use this endpoint to remove unused contact profiles from account.

    DELETE /api/domains/v1/whois/{whoisId}

Domains: Move

  • Read

    Get incoming domain move

    Retrieve the incoming move for a specified domain. Returns 404 when no account is moving this domain to you. Use this endpoint to check whether a domain addressed to you is still waiting to be accepted.

    GET /api/domains/v1/move/incoming/{domain}

  • Read

    Get incoming domain move list

    Retrieve all domains other Hostinger accounts are moving to your account. Moves of every status are returned, including the ones which already completed. Use this endpoint to find domains waiting for you to accept them.

    GET /api/domains/v1/move/incoming

  • Read

    Get outgoing domain move

    Retrieve the outgoing move for a specified domain. Returns 404 when the domain has no move in progress. Use this endpoint to track the status of a move you have initiated for a single domain.

    GET /api/domains/v1/move/outgoing/{domain}

  • Read

    Get outgoing domain move list

    Retrieve all domains you are moving to other Hostinger accounts. Only moves which have not completed yet are returned. Use this endpoint to track moves you have initiated and the accounts they are addressed to.

    GET /api/domains/v1/move/outgoing

  • Write

    Accept incoming domain move

    Accept an incoming move for a specified domain. The provided WHOIS profiles become the contacts of the domain, so they must belong to your account and satisfy the requirements of the TLD. Only the contact types the domain actually uses are applied, but all four profile IDs have to be provided. The move has to still be waiting for your decision, already accepted moves cannot be accepted again. Accepting does not complete the move. A confirmation email is sent to the email address of the new owner contact, and the domain changes hands only after the change is confirmed from it. Until then the move stays in the `activating` status, which can be followed with the [incoming move endpoint](#tag/domains-move). Use this endpoint to take ownership of a domain offered to you.

    PUT /api/domains/v1/move/incoming/{domain}

  • Write

    Start outgoing domain move

    Initiate a move of a specified domain to another Hostinger account. The receiving account has to already exist and accept the move before the domain changes hands. The domain must be active. The subscription it belongs to is resolved automatically, and the request is rejected with a 404 status code when the domain has no domain subscription of its own. Domains protected by premium protection require an additional verification step, such requests are rejected with a 428 status code. Use this endpoint to hand a domain over to another Hostinger user.

    POST /api/domains/v1/move/outgoing/{domain}

  • Destructive

    Reject incoming domain move

    Reject an incoming move for a specified domain. The domain stays in the account which initiated the move. Moves you have already accepted cannot be rejected anymore. Use this endpoint to decline a domain you do not want to take over.

    DELETE /api/domains/v1/move/incoming/{domain}

  • Destructive

    Cancel outgoing domain move

    Cancel an outgoing move for a specified domain. The move can only be cancelled while the receiving account has not accepted it yet. The domain stays in your account. Use this endpoint to withdraw a move you no longer want to complete.

    DELETE /api/domains/v1/move/outgoing/{domain}

Domains: Portfolio

  • Read

    Get domain authorization code

    Retrieve the authorization (EPP) code for a specified domain so it can be transferred away from Hostinger to another registrar. Requesting a new code invalidates any code retrieved previously. Use this endpoint to obtain the code required to transfer a domain to another registrar.

    GET /api/domains/v1/portfolio/{domain}/auth-code

  • Read

    Get domain details

    Retrieve detailed information for specified domain. Use this endpoint to view comprehensive domain configuration and status.

    GET /api/domains/v1/portfolio/{domain}

  • Read

    Get domain list

    Retrieve all domains associated with your account. Use this endpoint to view user's domain portfolio.

    GET /api/domains/v1/portfolio

  • Read

    Get domain renewal information

    Retrieve renewal information for a specified domain, including its status and current expiration date. Use this endpoint to build renewal automation and expiry monitoring for a single domain.

    GET /api/domains/v1/portfolio/{domain}/renewal

  • Write

    Claim free domain

    Claim a free domain available on your account and register it. Unlike purchasing a domain, this consumes a free domain you already have, so no payment method is required. A successful response means the domain is registered. If registration fails, login to [hPanel](https://hpanel.hostinger.com/) and check domain registration status. If no WHOIS information is provided, default contact information for that TLD will be used. Before making request, ensure WHOIS information for desired TLD exists in your account. Some TLDs require `additional_details` to be provided and these will be validated before claiming. Requests which cannot be fulfilled are rejected with an error code in the response body, for example `2037` when no free domain is available. Use this endpoint to register a domain using a free domain from your account.

    POST /api/domains/v1/portfolio/claim

  • Write

    Enable domain lock

    Enable domain lock for the domain. When domain lock is enabled, the domain cannot be transferred to another registrar without first disabling the lock. Use this endpoint to secure domains against unauthorized transfers.

    PUT /api/domains/v1/portfolio/{domain}/domain-lock

  • Write

    Purchase new domain

    Purchase and register a new domain name. If registration fails, login to [hPanel](https://hpanel.hostinger.com/) and check domain registration status. If no payment method is provided, your default payment method will be used automatically. If the response is `202 Accepted`, the payment is still being processed and the domain was **not** registered. Once the order completes, register the domain from [hPanel](https://hpanel.hostinger.com/). If no WHOIS information is provided, default contact information for that TLD will be used. Before making request, ensure WHOIS information for desired TLD exists in your account. Some TLDs require `additional_details` to be provided and these will be validated before completing purchase. Use this endpoint to register new domains for users.

    POST /api/domains/v1/portfolio

  • Write

    Enable privacy protection

    Enable privacy protection for the domain. When privacy protection is enabled, domain owner's personal information is hidden from public WHOIS database. Use this endpoint to protect domain owner's personal information from public view.

    PUT /api/domains/v1/portfolio/{domain}/privacy-protection

  • Write

    Complete domain setup

    Register a domain you have already paid for but which has not been set up yet. Use this endpoint when an order completed without registering the domain, for example when `Purchase new domain` returned `202 Accepted` and the domain was added to your account without being registered, or when an earlier setup attempt failed. No new order is placed and no payment is taken: the subscription you already own is used, for the period you already paid for. A domain is left awaiting setup when the details needed to register it were missing or invalid as the order completed. Domains ordered elsewhere can be awaiting setup for the same reason. Complete the missing information, then call this endpoint. If the order itself has not completed yet, the domain is not on your account, wait until it appears in `Get domain list`. If `domain_contacts` is omitted, the default WHOIS profile of that TLD is used for all four roles. The profile must exist and be complete for the TLD, an incomplete profile is the most common reason a domain is left awaiting setup. Create one with `Create WHOIS profile`. Some TLDs require `additional_details`. These are validated before setup, so a missing or invalid value is rejected without any registration being attempted. The domain is set up with the default nameservers and with privacy protection. Use `Update domain nameservers` and `Disable privacy protection` afterwards to change either. A successful response means the setup request was accepted, not that the domain is already registered. Poll `Get domain list` for the outcome, the domain appears in `Get domain details` only once it is registered. Use this endpoint to finish registering a domain that is awaiting setup on your account.

    POST /api/domains/v1/portfolio/{domain}/setup

  • Write

    Update domain nameservers

    Set nameservers for a specified domain. Be aware, that improper nameserver configuration can lead to the domain being unresolvable or unavailable. Use this endpoint to configure custom DNS hosting for domains.

    PUT /api/domains/v1/portfolio/{domain}/nameservers

  • Destructive

    Disable domain lock

    Disable domain lock for the domain. Domain lock needs to be disabled before transferring the domain to another registrar. Use this endpoint to prepare domains for transfer to other registrars.

    DELETE /api/domains/v1/portfolio/{domain}/domain-lock

  • Destructive

    Disable privacy protection

    Disable privacy protection for the domain. When privacy protection is disabled, domain owner's personal information is visible in public WHOIS database. Use this endpoint to make domain owner's information publicly visible.

    DELETE /api/domains/v1/portfolio/{domain}/privacy-protection

Domains: Transfer

  • Read

    Get transfer

    Retrieve the transfer for a specified domain. Use this endpoint to track an incoming or outgoing registrar transfer and its status.

    GET /api/domains/v1/transfers/{domain}

  • Read

    Get transfer list

    Retrieve all domain transfers in your portfolio. Use this endpoint to monitor incoming and outgoing registrar transfers across your domains.

    GET /api/domains/v1/transfers

  • Write

    Claim free domain transfer

    Claim a free domain transfer available on your account and start the transfer. Unlike purchasing a transfer, this consumes a free domain transfer you already have, so no payment method is required. Before making request, unlock the domain at the current registrar and get its authorization code. The transfer is validated first, so domains which cannot be transferred are rejected before the free domain transfer is consumed. A successful response means the transfer has been started. Completion depends on the current registrar and can be followed with the [transfer list endpoint](#tag/domains-transfer). If no WHOIS information is provided, default contact information for that TLD will be used. Before making request, ensure WHOIS information for desired TLD exists in your account. Requests which cannot be fulfilled are rejected with an error code in the response body. Use this endpoint to transfer a domain using a free domain transfer from your account.

    POST /api/domains/v1/transfers/claim

  • Write

    Start domain transfer

    Transfer a domain from another registrar to your account. The transfer runs on a domain transfer service you have already purchased. Before making request, unlock the domain at the current registrar and get its authorization code. A successful response means the transfer has been started. Completion depends on the current registrar and can be followed with the [transfer list endpoint](#tag/domains-transfer). If no WHOIS information is provided, default contact information for that TLD will be used. Before making request, ensure WHOIS information for desired TLD exists in your account. Use this endpoint to bring domains registered elsewhere into your account.

    POST /api/domains/v1/transfers

Ecommerce: Discounts

  • Read

    List discounts

    List a store's discounts. Filter by free text over code and name, or by disabled state. Amounts for fixed discounts are integers in the smallest currency unit; percentage discounts carry a whole-number value between 1 and 100.

    GET /api/ecommerce/v1/stores/{store_id}/discounts

  • Write

    Create a discount

    Create a discount for a store. Fixed discounts take an amount in the smallest currency unit (e.g. $10 is 1000); percentage discounts take a whole-number value between 1 and 100. Free-shipping discounts ignore value. Returns the created discount.

    POST /api/ecommerce/v1/stores/{store_id}/discounts

Ecommerce: Miscellaneous

  • Read

    Get custom storefront setup instructions

    Retrieve step-by-step setup instructions, formatted as Markdown, for connecting a custom sales channel to your store and keeping your catalog, orders, shipping and payments in sync through the Ecommerce API.

    GET /api/ecommerce/v1/miscellaneous/custom-storefront-instructions

Ecommerce: Orders

  • Read

    List store orders

    List a store's orders newest first as summaries. Filter by status, payment or fulfilment status, customer email, order number or a free-text query. Amounts are in the smallest currency unit. Retrieve a single order for its line items, addresses and fulfilments.

    GET /api/ecommerce/v1/stores/{store_id}/orders

  • Read

    Retrieve an order

    Retrieve one order in full: line items (each with the id the fulfil endpoint needs), addresses, the totals breakdown and fulfilments with tracking. Amounts are in the smallest currency unit.

    GET /api/ecommerce/v1/stores/{store_id}/orders/{order_id}

  • Write

    Fulfil an order

    Create a fulfilment for the order and attach tracking in one call. Omit items to fulfil every remaining unfulfilled item. Returns the updated order summary.

    POST /api/ecommerce/v1/stores/{store_id}/orders/{order_id}/fulfill

  • Destructive

    Cancel an order

    Cancel the order and optionally email the customer. Returns the updated order summary.

    POST /api/ecommerce/v1/stores/{store_id}/orders/{order_id}/cancel

Ecommerce: Payments

  • Read

    List store payment providers

    List a store's payment providers, split into providers already connected to the store and gateways available to install. Never exposes gateway credentials, secrets, or configuration.

    GET /api/ecommerce/v1/stores/{store_id}/payment-providers

  • Write

    Enable manual payment method

    Enable a manual payment method so the store can accept orders without an online payment provider.

    POST /api/ecommerce/v1/stores/{store_id}/payment-methods/manual

  • Write

    Create a payment provider connect link

    Create an onboarding link for connecting a payment gateway to the store. Returns the gateway onboarding URL for the merchant to open and a deep-link into the store admin.

    POST /api/ecommerce/v1/stores/{store_id}/payment-providers/{provider_id}/connect-link

Ecommerce: Products

  • Read

    List products

    List a store's products newest first as lean summaries (name, status, thumbnail, variant count and price range). Prices are integers in the smallest currency unit and live on variants. Filter by status, free text or a set of product ids. Use include=variants to embed each product's variants with prices and inventory, and include=media to embed its media.

    GET /api/ecommerce/v1/stores/{store_id}/products

  • Write

    Create a product image upload URL

    Returns a signed URL to upload a product image to (multipart/form-data POST). Then call the attach-image endpoint with the returned object_name to scan and attach it to the product.

    POST /api/ecommerce/v1/stores/{store_id}/products/{product_id}/images/upload-url

  • Write

    Create digital product

    Create a published digital product with a single variant and an optional external download link.

    POST /api/ecommerce/v1/stores/{store_id}/products/digital

  • Write

    Create physical product

    Create a published physical product with a single variant priced in the store currency.

    POST /api/ecommerce/v1/stores/{store_id}/products/physical

  • Write

    Upload and attach a product image

    Fetch a raster image (JPEG, PNG, GIF or WebP, max 15MB) from a URL and attach it to a product in a single call. Image downloads require HTTPS on port 443 without embedded credentials. At most one redirect is allowed, and its destination must meet the same requirements. Private or reserved network destinations, unsupported URLs and longer redirect chains are rejected. The image is virus-scanned and validated by content, then stored on the CDN. Set is_thumbnail to make it the product's primary image.

    POST /api/ecommerce/v1/stores/{store_id}/products/{product_id}/images

  • Destructive

    Delete a product

    Delete a product and its variants from the store. A subscription product with active subscribers is archived instead of deleted so its data stays available.

    DELETE /api/ecommerce/v1/stores/{store_id}/products/{product_id}

  • Destructive

    Update a product

    Update a product's name, description, status, SEO settings or collections. Set status to published to make it buyable, draft to hide it, or archived to retire it. SEO settings (title, description, slug) left out keep their values. collection_changes adds or removes collections without touching the others. Variants, prices and inventory are managed through the variant endpoints, not here. Returns the updated product summary.

    PATCH /api/ecommerce/v1/stores/{store_id}/products/{product_id}

Ecommerce: Sales channels

  • Read

    List sales channels

    List a store's active sales channels with their full metadata.

    GET /api/ecommerce/v1/stores/{store_id}/sales-channels

  • Write

    Create a sales channel

    Create a sales channel for a store. A "custom" channel is headless: build your own frontend and keep your catalog, orders, shipping and payments in sync through the Ecommerce API. A "quick-link" channel is a hosted one-page store whose handle is auto-generated.

    POST /api/ecommerce/v1/stores/{store_id}/sales-channels

  • Destructive

    Update sales channel

    Update a custom sales channel. The merchant-facing `name` and the public `url` (returned as the channel `domain`) can be changed. Pass `null` to clear a value.

    PATCH /api/ecommerce/v1/stores/{store_id}/sales-channels/{sales_channel_id}

Ecommerce: Shipping

  • Write

    Set store shipping

    Set the flat-rate shipping price for a store, creating the shipping zone if it does not exist yet.

    POST /api/ecommerce/v1/stores/{store_id}/shipping

Ecommerce: Stores

  • Read

    Get stores

    Retrieve the stores associated with your account.

    GET /api/ecommerce/v1/stores

  • Read

    Get store metadata

    Get a store's readiness metadata: whether payment methods and shipping are configured, plus its default currency. Useful to verify prerequisites before building a storefront.

    GET /api/ecommerce/v1/stores/{store_id}/metadata

  • Write

    Create store

    Create a new store for your account. A primary sales channel is created alongside the store.

    POST /api/ecommerce/v1/stores

  • Destructive

    Delete store

    Soft-delete a store owned by your account. The underlying store data is preserved; only the store is marked as deleted.

    DELETE /api/ecommerce/v1/stores/{store_id}

Ecommerce: Product variants

  • Read

    List product variants

    List a product's variants, ordered by rank, with their options, prices and inventory. Prices are integers in the smallest currency unit and live on variants.

    GET /api/ecommerce/v1/stores/{store_id}/products/{product_id}/variants

  • Write

    Create a product variant

    Add a variant to a product along one or more option dimensions (e.g. Size, Color). Options missing from the product are created automatically; provide a value for every option the product already has. Prices are integers in the smallest currency unit and default to the store currency. Returns the created variant.

    POST /api/ecommerce/v1/stores/{store_id}/products/{product_id}/variants

  • Destructive

    Update product variants in batch

    Update up to 100 existing variants in place by id — title, SKU, inventory, stock tracking and prices. Variants omitted from the request are left untouched. Prices replace the variant's existing prices in full. Returns the updated variants.

    PATCH /api/ecommerce/v1/stores/{store_id}/products/{product_id}/variants/batch

  • Destructive

    Delete a product variant

    Delete a single variant from the product.

    DELETE /api/ecommerce/v1/stores/{store_id}/products/{product_id}/variants/{variant_id}

Horizons: Websites

  • Read

    Get website list

    List the Hostinger Horizons websites the user owns.\n Use this tool when the user asks which websites they have, or when you need a website ID before editing, publishing or cloning a website.\n Each website is returned with its ID, status, domain and the URL to open it in Hostinger Horizons interface.\n The complete list of websites is returned in a single response - it is not paginated.

    GET /api/horizons/v1/websites

  • Read

    Get website

    Get the link for the user to open their website in Hostinger Horizons interface.\n Use this tool when the user wants the link to an existing website, or when you need its website URL before or after editing it.\n `is_in_progress` is true while changes are being generated or the website is being published; wait until it is false before publishing. `published_at` is when the website was last published, `is_template` is whether its published pages show the "Use template" banner, and `has_ecommerce_store` is whether it has an online store.\n Websites can be edited with the `Edit website` tool, or by the user in Hostinger Horizons interface in the provided website URL.

    GET /api/horizons/v1/websites/{websiteId}

  • Write

    Clone website

    Clone a Hostinger Horizons website into a new website.\n Use this tool when the user wants a copy of an existing website, for example to try out changes without touching the original.\n This tool returns the ID and URL of the newly created copy. The original website is left untouched.\n To edit the copy, use the `Edit website` tool with the returned website ID, or the user can open the provided website URL in Hostinger Horizons interface.

    POST /api/horizons/v1/websites/{websiteId}/clone

  • Write

    Create website

    Create new Hostinger Horizons website from the given message.\n Use this tool when user asks you to create a website, landing page, blog or any other type of application.\n This tool initiates the website creation process and returns a website URL and ID. The generation happens asynchronously.\n After invoking this tool, your chat reply must be EXACTLY 1 sentence summarizing that Hostinger Horizons is now creating their website and it will be ready in a few minutes and you should provide the website URL to the user immediately Do not write code.\n\nTo edit afterwards, use the `Edit website` tool with the returned website ID, or the user can go to Hostinger Horizons interface in the provided website URL. If the tool call fails with an error, you should provide a clear explanation of the error and do not generate code yourself in the chat. \n TECHNOLOGY STACK CONSTRAINTS (STRICTLY ENFORCED):\n The environment is limited to the following technologies. You MUST NOT use, suggest, or implement any technology outside this list:\n \n - Language: JavaScript ONLY. - Languages like TypeScript, Rust, Python, Java, PHP, etc., are STRICTLY PROHIBITED.\n - Framework: React.\n - Navigation: React Router.\n - Styling: TailwindCSS.\n - Components: shadcn/ui (built with @radix-ui primitives).\n - Icons: Lucide React.\n - Animations: Framer Motion.\n \n BACKEND & DATA STORAGE:\n - Horizons integrated backend is the EXCLUSIVE solution for persistent data storage, authentication, and database needs.\n - Local databases (SQLite, MySQL, etc.) are STRICTLY PROHIBITED.\n - Third-party services (Firebase, AWS Amplify) are allowed ONLY if explicitly requested by the user.\n \n MAPS:\n - OpenStreetMap is the default provider.\n - Alternative providers (Google Maps, Mapbox) are allowed ONLY if explicitly requested by the user.\n

    POST /api/horizons/v1/websites

  • Write

    Edit website

    Edit an existing Hostinger Horizons website with a follow-up message.\n Use this tool when the user wants to change, extend or fix a website that already exists.\n This tool queues the requested changes and returns the website URL and ID. The changes are applied asynchronously.\n After invoking this tool, your chat reply must be EXACTLY 1 sentence summarizing that Hostinger Horizons is now applying the requested changes and they will be ready in a few minutes, and you should provide the website URL to the user immediately. Do not write code.\n If the tool call fails with an error, you should provide a clear explanation of the error and do not generate code yourself in the chat.

    POST /api/horizons/v1/websites/{websiteId}/messages

  • Destructive

    Publish website

    Publish a Hostinger Horizons website so its latest changes go live.\n Use this tool when the user asks to publish, deploy or make their website live.\n This tool starts the publish process and returns the URL the website will be live on. Publishing happens asynchronously and takes a few minutes.\n Set `is_template` only when the user explicitly asks to share the website as a template: true adds a "Use template" banner to its published pages that copies the website into the visitor's own account, and false removes it. Leave it out to keep the current setting.\n After invoking this tool, your chat reply must be EXACTLY 1 sentence summarizing that the website is being published and you should provide the published URL to the user immediately.

    POST /api/horizons/v1/websites/{websiteId}/publish

Hosting: Cache

  • Read

    Get cache status

    Returns the caching state of the website: whether server-side caching is enabled and whether development (cacheless) mode is on. Works for the main domain, addon websites, parked domains and subdomains of the account; each reports its own settings and does not inherit them from its parent website. `is_enabled` is the setting changed by `Toggle website cache` and reflects a toggle immediately. `is_cacheless_mode_enabled` is true while development mode is on; caching is then bypassed even when `is_enabled` is true. `Toggle cacheless mode` is applied in the background, so this flag can take a few minutes to follow it. The domain must be the exact website name as listed on the account, without a `www.` prefix. Returns 404 when the domain is not a website on the account.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/cache/status

  • Write

    Toggle cacheless mode

    Turns development (cacheless) mode on or off, based on the enabled flag. When enabled, nothing is cached, effectively turning off all caching for the website; use it while actively developing, testing changes, debugging issues, or when real-time updates must be visible. Disable it after finishing development work to restore the performance benefits of caching. The change is applied in the background and can take a few minutes. Use `Get cache status` to check the current state.

    PATCH /api/hosting/v1/accounts/{username}/websites/{domain}/cacheless-mode/toggle

  • Write

    Toggle website cache

    Turns server-side caching for the website on or off, based on the enabled flag. Enable it for faster page loads, reduced server load, and improved user experience; recommended for production websites. Disabling may impact performance; to temporarily bypass caching while developing or debugging, prefer toggling cacheless mode instead. Does nothing if caching is already in the requested state. Use `Get cache status` to check the current state.

    PATCH /api/hosting/v1/accounts/{username}/websites/{domain}/cache/toggle

  • Destructive

    Clear website cache

    Permanently clears all server-side cache for the website at once. Use it when content was updated and needs to be visible immediately, or after making major changes. Also purges the Hostinger CDN cache when CDN is enabled on the website. To purge only the CDN cache and leave the server cache untouched, use `Purge CDN cache`. For a WordPress installation living in a subdirectory, pass the directory query parameter to clear its cache.

    DELETE /api/hosting/v1/accounts/{username}/websites/{domain}/cache/clear

Hosting: CDN

  • Read

    Get CDN status

    Returns whether the Hostinger CDN is enabled for the website domain. Works for the main domain, parked domains and subdomains of the account. The domain must be the exact website name as listed on the account, without a `www.` prefix. Returns 404 when the domain is not a website on the account.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/cdn/status

  • Destructive

    Disable CDN

    Turns off the Hostinger CDN for the website domain. Once DNS propagation completes, the website content is served directly from the origin server. Repeating the call is safe; when CDN is already disabled, it applies the DNS change again. Returns 422 for platform-managed domains (for example `*.hostingersite.com` and `*.app-preview.com`), where CDN cannot be disabled, even when CDN is already off. Also returns 422 while the account is being moved to another server (retry after the move finishes), or when the CDN provider rejects the change. Returns 404 when the domain is not a website on the account.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/cdn/disable

  • Destructive

    Enable CDN

    Turns on the Hostinger CDN for the website domain, which speeds up page loads and reduces the load on the server. Works for the main domain, parked domains and subdomains of the account. Enabling changes the domain's DNS records and usually takes a few seconds. After that, DNS propagation can take a few more minutes before visitors are served through the CDN. Repeating the call is safe, for example after a timeout. When CDN is already enabled, it applies the DNS change again and refreshes the CDN SSL certificate. Returns 422 when the account is disabled, while the account is being moved to another server (retry after the move finishes), or when the CDN provider rejects the change. Returns 404 when the domain is not a website on the account.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/cdn/enable

  • Destructive

    Purge CDN cache

    Purges the website's content from the Hostinger CDN edge cache only. The origin server cache is not touched; to clear both, use `Clear website cache`. Returns 422 when CDN is not enabled on the website. Returns 404 when the domain is not a website on the account.

    DELETE /api/hosting/v1/accounts/{username}/websites/{domain}/cdn/purge

Hosting: Cron Jobs

  • Read

    List account cron jobs

    Returns the list of cron jobs configured for the specified account, including their schedule and command.

    GET /api/hosting/v1/accounts/{username}/cron-jobs

  • Read

    Get cron job output

    Returns the output captured from the last execution of the cron job identified by its uid. The uid is returned by the list cron jobs endpoint.

    GET /api/hosting/v1/accounts/{username}/cron-jobs/{uid}/output

  • Write

    Create account cron job

    Creates a cron job for the specified account from a schedule expression and a command. Returns the created cron job, including its uid, which is required to delete the cron job or fetch its output.

    POST /api/hosting/v1/accounts/{username}/cron-jobs

  • Destructive

    Delete account cron job

    Permanently deletes the cron job identified by its uid. The uid is returned by the list cron jobs endpoint.

    DELETE /api/hosting/v1/accounts/{username}/cron-jobs/{uid}

Hosting: Databases

  • Read

    List account databases

    Returns a paginated list of databases for the specified account. Use the domain and is_assigned filters to find databases assigned to a specific domain.

    GET /api/hosting/v1/accounts/{username}/databases

  • Read

    List database remote connections

    Returns the remote-access rules for the specified account: the remote hosts (IPv4/IPv6 addresses, or "%" for any host) allowed to connect to the account databases. Use the domain filter to only return rules for databases assigned to a specific domain.

    GET /api/hosting/v1/accounts/{username}/databases/remote-connections

  • Read

    Get phpMyAdmin link

    Returns a direct sign-on link to phpMyAdmin for the specified database. Use this when a visual database interface is needed for SQL queries, imports, exports, or table management. The database name must be the full name returned by the list databases endpoint.

    GET /api/hosting/v1/accounts/{username}/databases/{name}/phpmyadmin-link

  • Write

    Change database password

    Changes the password for the specified database user. The database name must be the full name returned by the list databases endpoint. The password must also be updated in any website configuration that uses this database.

    PATCH /api/hosting/v1/accounts/{username}/databases/{name}/change-password

  • Write

    Create account database

    Creates a database with a database user and password for the specified account. The database name and user are automatically prefixed with the account username when needed.

    POST /api/hosting/v1/accounts/{username}/databases

  • Write

    Create database remote connection

    Allows a remote host to connect to the specified database. Provide an IPv4/IPv6 address, or "%" to allow any host. The database name must be the full name returned by the list databases endpoint. Database creation is synchronous, so a 404 here means no database with that name exists under the username, not that it is still being created.

    POST /api/hosting/v1/accounts/{username}/databases/{name}/remote-connections

  • Write

    Repair database

    Repairs corrupted database tables asynchronously. Use when database errors, crashes, or corruption are reported. The database name must be the full name returned by the list databases endpoint.

    PATCH /api/hosting/v1/accounts/{username}/databases/{name}/repair

  • Destructive

    Delete account database

    Permanently deletes a database and its remote connections. The database name must be the full name returned by the list databases endpoint.

    DELETE /api/hosting/v1/accounts/{username}/databases/{name}

  • Destructive

    Delete database remote connection

    Permanently removes a remote-access rule, revoking the given host's remote access to the database. Identify the rule with the required ip query parameter (the IPv4/IPv6 address, or "%", exactly as returned by the list remote connections endpoint). The database name must be the full name returned by the list databases endpoint.

    DELETE /api/hosting/v1/accounts/{username}/databases/{name}/remote-connections

  • Destructive

    Setup website database

    Creates a new MySQL database for the website and writes its connection details into the website's environment variables, then restarts the application. The platform generates the password (and the database name and user, unless supplied). The password is never returned; the application reads it from the environment. Written variables: `DB_HOST`, `DB_PORT`, `DB_NAME`, `DB_USER`, `DB_PASSWORD` and `DATABASE_URL` (`mysql://user:password@host:port/name`, user and password percent-encoded). Existing variables are kept. If the website already has any variable with one of these names the call fails with 422 and nothing is created; the `Replace Node.js environment variables` endpoint removes them. After this call the variables are ordinary environment variables: the `Replace Node.js environment variables` endpoint changes or removes them like any other. A restart is enough for apps that read environment variables at process start, such as Express or NestJS. Frameworks that bake variables into the build output (Next.js, `NEXT_PUBLIC_*`) see the new values only after a fresh build (`Start Node.js build` endpoint). A password in the request is ignored; the platform always generates it. The optional `name` and `user` are identifiers, not secrets.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/databases/setup

Hosting: Datacenters

  • Read

    List available datacenters

    Retrieve a list of datacenters available for setting up hosting plans based on available datacenter capacity and hosting plan of your order. The first item in the list is the best match for your specific order requirements.

    GET /api/hosting/v1/datacenters

Hosting: Domains

  • Read

    List website parked domains

    Retrieve all parked or alias domains created under the selected website. Use this endpoint to inspect parked domain configuration for a specific website, including the parent domain and root directory assigned to each parked domain.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains

  • Read

    List website subdomains

    Retrieve all subdomains created under the selected website. Use this endpoint to inspect subdomain configuration for a specific website, including the parent domain and root directory assigned to each subdomain.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/subdomains

  • Write

    Generate a free subdomain

    Generate a unique free subdomain that can be used for hosting services without purchasing custom domains. Free subdomains allow you to start using hosting services immediately and you can always connect a custom domain to your site later.

    POST /api/hosting/v1/domains/free-subdomains

  • Write

    Create website parked domain

    Create a parked or alias domain for the selected website. Provide a domain name or IP address to park on the website so it serves the same content as the parent domain.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains

  • Write

    Create website subdomain

    Create a new subdomain for the selected website. Provide a subdomain prefix and, optionally, a custom directory or the website public directory to use as the subdomain root.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/subdomains

  • Write

    Verify domain ownership

    Verify ownership of a single domain and return the verification status. Use this endpoint to check if a domain is accessible for you before using it for new websites. If the domain is accessible, the response will have `is_accessible: true`. If not, add the given TXT record to your domain's DNS records and try verifying again. Keep in mind that it may take up to 10 minutes for new TXT DNS records to propagate. Skip this verification when using Hostinger's free subdomains (*.hostingersite.com).

    POST /api/hosting/v1/domains/verify-ownership

  • Destructive

    Delete website parked domain

    Delete an existing parked or alias domain from the selected website. Use this endpoint to remove parked domains that are no longer needed.

    DELETE /api/hosting/v1/accounts/{username}/websites/{domain}/parked-domains/{parkedDomain}

  • Destructive

    Delete website subdomain

    Delete an existing subdomain from the selected website. Use this endpoint to remove subdomains that are no longer needed.

    DELETE /api/hosting/v1/accounts/{username}/websites/{domain}/subdomains/{subdomain}

Hosting: Files

  • Read

    List website files and directories

    List files and directories under a website's document root. Use `directory` to browse a subdirectory relative to the document root. Symlinked entries are listed but never traversed into or resolved.

    GET /api/hosting/v1/accounts/{username}/domains/{domain}/files

  • Read

    Get website file content

    Get a single file's content, relative to a website's document root. Read-only; refuses symlinks, oversized files, non-text file types, and files identified as containing secrets (e.g. credential files) — none of these are returned by this endpoint.

    GET /api/hosting/v1/accounts/{username}/domains/{domain}/files/content

  • Write

    Generate upload URL

    Generate a file browser upload URL with authentication credentials for uploading files directly to a website's file storage. While the website is still being set up (`status: running` on the list website setups endpoint) this endpoint returns 409 with a `Retry-After` header: wait that many seconds and retry, or poll the website setups until the status is `completed`. Returns `url`, `auth_key` and `rest_auth_key`. Use these to upload a file to the website's `public_html` directory via the TUS resumable upload protocol (TUS 1.0.0). Send `X-Auth: {auth_key}` and `X-Auth-Rest: {rest_auth_key}` headers on every request below. 1. Create the upload: `POST` to `{url}/{relative_file_path}?override=true` with headers `upload-length: {file size in bytes}` and `upload-offset: 0`. Expect `201 Created`. 2. Upload the file: send the file bytes to the same location (any TUS 1.0.0 client, or `PATCH` requests with an `upload-offset` header tracking progress) until complete. `relative_file_path` is the destination path inside `public_html`, e.g. `app.zip`. Instead of a TUS client, plain `curl` also works: ``` FILE=app.zip SIZE=$(stat -f%z "$FILE") # stat -c%s on Linux curl -i -X POST "{url}/${FILE}?override=true" \ -H "X-Auth: {auth_key}" \ -H "X-Auth-Rest: {rest_auth_key}" \ -H "Tus-Resumable: 1.0.0" \ -H "Upload-Length: ${SIZE}" \ -H "Upload-Offset: 0" # -> 201 Created curl -i -X PATCH "{url}/${FILE}?override=true" \ -H "X-Auth: {auth_key}" \ -H "X-Auth-Rest: {rest_auth_key}" \ -H "Tus-Resumable: 1.0.0" \ -H "Content-Type: application/offset+octet-stream" \ -H "Upload-Offset: 0" \ --data-binary "@${FILE}" # -> 204 No Content, Upload-Offset response header equals SIZE when done ```

    POST /api/hosting/v1/files/upload-urls

Hosting: Git

  • Read

    Get Git auto-deployment settings

    Returns the Git auto-deployment settings of the website: which repository and branch deploy into which directory, and whether pushes trigger a deployment. `is_enabled` false keeps the repository link but ignores pushes. When the website has no auto-deployment configured every field is null. Save settings with `Update Git auto-deployment settings`.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/git/auto-deployments/settings

  • Read

    List Git installations

    Lists the Git provider accounts the customer has connected. Only installations with status `active` are returned unless the `status` filter says otherwise. An empty list means the customer has no active installation. Check `status=suspended` and `status=pending` as well. If there is none at all, a Git provider (GitHub or GitLab) has to be connected once in hPanel (Websites, Manage, Advanced, Git; or Add Website, Node.js Web App, Import Git Repository); this endpoint then lists the new installation. Use `uuid` as the path parameter of `List Git installation repositories`, and as `installation_uuid` in `Start Node.js build` with `source_type` `git` and in `Update Git auto-deployment settings`.

    GET /api/hosting/v1/git/installations

  • Read

    List Git installation repositories

    Lists the repositories the Git installation can access, read live from the provider. Works for github and gitlab installations. Use an active installation: a suspended or pending one is still queried and the call fails with whatever the provider answers. The list is cut at the first 500 repositories in the order the provider returns them; when the account has more, name the repository directly instead of searching this list. `owner`, `name` and a branch (`default_branch` or another one) go into `source_options` of `Start Node.js build` or into `Update Git auto-deployment settings`. Returns 404 when the installation does not belong to the customer. Limited to 10 calls per minute per API client (429 above that).

    GET /api/hosting/v1/git/installations/{uuid}/repositories

  • Read

    List website Git repositories

    Lists the Git repositories linked to directories of the website, with `Deploy website Git repository` or in the Git section of hPanel: clone URL, branch and directory of each one. A repository whose clone failed stays listed; deploying it again retries the clone. GitHub and GitLab auto-deployments are not listed here; see `Get Git auto-deployment settings`.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/git/repositories

  • Read

    Get Git SSH public key

    Returns the public SSH key of the hosting account. `Deploy website Git repository` uses this key to clone and pull over SSH, so a private repository works once the key is added to it as a deploy key on the Git host. `public_key` is null when the account has no key yet.

    GET /api/hosting/v1/accounts/{username}/git/ssh-key

  • Write

    Deploy website Git repository

    Clones a Git repository into a directory of the website, or pulls it again. An empty or missing directory gets a clone of the branch. A directory that already holds this repository and branch is reset to its last commit and pulled: changes made on the server to files the repository tracks are discarded, files it does not track stay. A directory that holds other files, including another repository or another branch of this one, is rejected. `composer install` runs after the clone or pull when the repository has a `composer.json`. The call waits for the deployment and returns its log. `is_success` false means Git or composer failed and the log says why. A second call for the same directory is rejected while the first is still waiting for the server. If the request times out, the deployment may still finish on the server; calling again later with the same repository and branch pulls. Private repositories need an SSH URL and the account's Git SSH key from `Generate Git SSH key`, added to the repository as a deploy key.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/git/repositories/deploy

  • Write

    Generate Git SSH key

    Creates the SSH key pair of the hosting account and returns the public key. When the account already has a key, returns that key unchanged. One key serves every website of the account; add the public key to a private repository as a deploy key before deploying it.

    POST /api/hosting/v1/accounts/{username}/git/ssh-key

  • Destructive

    Update Git auto-deployment settings

    Creates or replaces the Git auto-deployment settings of the website: repository, branch, the directory under the document root to deploy into, and `is_enabled`. Send the full set; `is_enabled` defaults to true and `directory` to the document root. `installation_uuid` must be an installation from `List Git installations` that belongs to the same customer as the website. For PHP and static websites, saving with `is_enabled` true deploys the branch right away and every later push to that branch deploys again. For Node.js and Website Builder websites saving does not clone anything. On a Node.js website start the first deploy with `Start Node.js build` using `source_type` `git`; pushes then trigger new builds with the build settings stored for the website.

    PUT /api/hosting/v1/accounts/{username}/websites/{domain}/git/auto-deployments/settings

  • Destructive

    Delete Git auto-deployment settings

    Removes the Git auto-deployment settings of the website. Files already deployed stay on the website; pushes stop deploying until settings are saved again. Succeeds also when nothing is configured.

    DELETE /api/hosting/v1/accounts/{username}/websites/{domain}/git/auto-deployments/settings

Hosting: Headless

  • Write

    Submit headless build report

    Submits the build report the headless skill writes at the end of a run (including early stops), so Hostinger can learn where builds get stuck. Send one report per call, with the report JSON as the request body, unchanged. The report must match report.schema.json v1; an invalid report returns 422 and is not stored. The report is linked to the authenticated account, so do not add account details to it.

    POST /api/hosting/v1/headless/agent-reports

Hosting: NodeJS

  • Read

    List NodeJS builds

    Retrieve a paginated list of Node.js build processes for a specific website. Each build represents a single run of the Node.js build pipeline. Use the `states` query parameter to filter results by build state (pending, running, completed, failed). Use the `uuid` from a build to poll its output via the `Get Node.js Build Logs` endpoint.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds

  • Read

    Get Node.js build settings

    Returns the build settings stored for the website: framework (`app_type`), Node.js version, root and output directory, build script, entry file and package manager. Stored settings drive Git auto-deployment builds. A build started through the API uses the values sent in that request and saves them here only when no settings exist yet. Returns 404 until the first build or the first settings update stores them. Use this after a failed build to check whether the framework or the entry file were detected wrong, then fix them with the `Update Node.js build settings` endpoint.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings

  • Read

    Get Node.js build settings from archive

    Auto-detect Node.js build settings from a package.json inside an archive already on the server. Use this before calling `Start Node.js Build` to preview what settings will be used, or to let the user review and override values (framework, node version, root directory, output directory, build script) before committing to a build. The archive must already be present on the website's file storage. Use the `Generate Upload URL` endpoint to obtain credentials and upload the archive first.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings/from-archive

  • Read

    Get Node.js build settings from repository

    Determine the build settings for a Node.js application from the package.json file of a branch in a Git repository. Use before starting a Git-source build to find out the auto-detected settings instead of guessing them. The repository is read through a Git installation: take `installation_uuid` from `List Git installations` and `owner` and `repository` from `List Git installation repositories`. Returns 422 when the installation is not found, the repository or branch is not found, or the branch has no package.json.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings/from-repository

  • Read

    List Node.js environment variables

    Lists the Node.js environment variables currently set for the website. Values are always masked as `********` and cannot be read back through this API. Use this endpoint to see which keys are configured or to verify a change, not to read values. To change variables, use the `Replace Node.js environment variables` endpoint. It replaces the whole set, so never copy the masked values from this response into that request; send the full desired set with real values taken from the project `.env` file or the user prompt instead.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings/env

  • Read

    Analyse failed Node.js build

    Returns an AI analysis of why a build failed and how to fix it, based on the build logs, the project file list and package.json. Only builds in the `failed` state can be analysed; any other state returns 422. When no analysis could be produced both `analysis` and `solution` are null, in which case read `Get NodeJS build logs` instead. Each call runs the analysis again, so call it once per failed build and keep the result. Limited to 5 calls per minute per API client (429 above that).

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/{uuid}/analysis

  • Read

    Get Node.js build details

    Returns one build by UUID: its state (`pending`, `running`, `completed`, `failed`), the options it ran with and timestamps. Poll this while a build is pending or running. When it is failed, read `Get NodeJS build logs` and `Analyse failed Node.js build` for the cause. Returns 404 when the UUID does not belong to a build of this website.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/{uuid}

  • Read

    Get NodeJS build logs

    Retrieve logs from a specific Node.js build process. To stream live output while a build is running, poll this endpoint repeatedly while the build state is `running`, passing the previously returned `lines` count as `from_line` to fetch only new output since the last call. Log content may contain ANSI escape sequences (color codes).

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/{uuid}/logs

  • Read

    Get Node.js runtime logs

    Returns the Node.js application's runtime console log entries, oldest first, each with timestamp, level and message. On the first call send `period` (`1h`, `1d`, `1w` or `1m`) and optionally `levels` and `limit` (1-5000, default 1000); when more entries match than `limit`, the newest are kept. To poll for new entries send `total_lines + 1` from the previous response as `from_line` and omit `period`; `period` and `from_line` cannot be combined. Lines that are not JSON with a timestamp, level and message are skipped, so `logs` may hold fewer than `limit` entries while `total_lines` counts every raw line. Entries with a timestamp before `last_deployed_at` belong to the previous deployment. Returns an empty `logs` list when the application has not written a log file yet.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/runtime-logs

  • Read

    List Node.js vulnerabilities

    Lists known npm package vulnerabilities detected on a Node.js website, enriched with advisory metadata (severity, CVSS score, CVE, advisory URL). Results are sorted from the most severe to the least severe, then by publish date (newest first). Use the `severities` query parameter to filter. Vulnerabilities with `is_patchable` set to `true` can be auto-fixed via the `Patch Node.js Vulnerabilities` endpoint, which opens a GitHub pull request with updated package versions. Auto-fix is only available for websites deployed from a connected GitHub repository. Vulnerabilities with `is_patching_in_progress` set to `true` are already included in an open patch pull request; while any patch pull request is open, new patch requests for this website are rejected until it is merged or closed. Data comes from periodic dependency scans, so it may lag behind the latest deployment. An empty list means the most recent scan found no vulnerabilities; it does not guarantee the current deployment is vulnerability-free. Available on Business and Cloud Hosting plans.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/vulnerabilities

  • Write

    Restart Node.js application

    Restarts the Node.js server process for the website. Does not rebuild or redeploy the application. Use it to apply environment or configuration changes, or to recover a hung application. Only applicable to server-side applications (Express, Next.js, NestJS, etc.). Static front-end apps (React, Vue, Vite) have no persistent server process, so restarting them has no effect. Returns success even when the website has no server process to restart.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/server/restart

  • Write

    Patch Node.js vulnerabilities

    Patches the selected Node.js vulnerabilities by updating the affected package versions in `package.json` and opening a GitHub pull request in the connected repository. The customer reviews and merges the pull request; merging triggers the automatic deployment. Auto-fix is only available for websites deployed from a connected GitHub repository. Websites deployed from an archive have no auto-fix path and return a 404. The Hostinger GitHub App needs write access to the repository; without it the request fails with a 403 explaining the missing permission. Only vulnerabilities with `is_patchable` set to `true` can be patched. Non-patchable IDs in the selection are skipped; the pull request covers the patchable subset, listed in `patched_vulnerability_ids`. Selections without any patchable vulnerability are rejected with a 422. Only one patch pull request can be open at a time per website; close or merge it before patching again. Available on Business and Cloud Hosting plans.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/vulnerabilities/patch

  • Destructive

    Start Node.js build

    Start a Node.js build process using files already present on the website's file storage. WARNING: on success this overwrites the website's existing contents and cannot be undone — verify this is intended before calling this endpoint. With `source_type` `archive`, `source_options.archive_path` must point to an existing archive file on the server (relative to the website document root). Use the `Generate Upload URL` endpoint to obtain credentials and upload the archive first. To auto-detect build settings from an archive before starting, first call the `Get Node.js Build Settings from Archive` endpoint. With `source_type` `git`, `source_options` carries `owner`, `repository`, `branch` and `installation_uuid`. Take the installation from `List Git installations` and the owner and repository from `List Git installation repositories`; the branch is cloned at its current head. The installation must belong to the same customer as the website. The returned build `uuid` can be used to poll progress and retrieve logs via the `Get Node.js Build Logs` endpoint.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds

  • Destructive

    Update Node.js build settings

    Replaces the build settings stored for the website. Send the full set: `node_version` is required and every nullable field you omit is stored as null. Creates the settings when none exist yet. This does not start a build. Stored settings drive Git auto-deployment builds; a build started through the API uses the values sent in that request, so to rebuild with corrected settings call `Start Node.js build` with the same values. Typical fixes: a wrong `app_type` after auto-detection, or a missing `entry_file` for express, fastify, nest, nuxt and hono apps.

    PUT /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings

  • Destructive

    Replace Node.js environment variables

    Replaces the website's Node.js environment variables with the ones provided. This is a full replace: any variable not in the request is deleted, and sending an empty `env_vars` array deletes every variable. Saving writes the values and restarts the running Node.js process. A restart is enough for apps that read environment variables at process start, such as Express or NestJS. It is not enough for frameworks that bake variables into the build. Next.js standalone is one of those: build-time values (including `NEXT_PUBLIC_*`) need a fresh build. After this call, use the `Start Node.js build` endpoint so those apps pick up the new values. The `List Node.js environment variables` endpoint returns masked values (`********`), so never copy values from it into this request. Always send the full desired set with real values taken from the project `.env` file or the user prompt.

    PUT /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds/settings/env

  • Destructive

    Clear Node.js runtime logs

    Empties the Node.js application's runtime log file. This cannot be undone, so confirm with the user before calling it. Returns success even when no log file exists yet. Use it before reproducing a problem so the next `Get Node.js runtime logs` call returns only fresh entries; start that call with `period` again instead of reusing a `from_line` from before the clear.

    DELETE /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/runtime-logs

Hosting: Websites

  • Read

    List website setups

    Returns the website setups started in the last 24 hours for the hosting accounts accessible to the authenticated client, newest first. Narrow the list with the `order_id`, `subscription_id` or `domain` filters. Meant for polling right after creating a website or starting a website setup: the website shows up in the websites list before its server-side setup has finished, and while the setup is `running` endpoints that operate on that website may respond with `404` or `409`. Poll this endpoint with the `domain` filter every 10 to 15 seconds and wait for `status: completed` before uploading files, deploying or creating databases. `failed` means the setup stopped before finishing or has not reported progress for over an hour. Setups older than 24 hours are not listed. `type` is the website type the setup was started with (`wordpress`, `headless_empty`, `headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`), or `null` for an empty website.

    GET /api/hosting/v1/onboardings

  • Read

    List websites

    Retrieve a paginated list of websites (CloudLinux, Builder, and Horizons) accessible to the authenticated client. This endpoint returns websites from your hosting accounts as well as websites from other client hosting accounts that have shared access with you. Each website includes a `website_type` field describing the type of website detected on the underlying platform (`wordpress`, `builder`, `horizons`, `nodejs`, or `other`). Some fields, such as `vhost_type`, `username`, and `root_directory`, only apply to CloudLinux websites and are null for other platforms. Use `website_types` to list only websites of a given detected type, e.g. only WordPress websites (`website_types=wordpress`) or only Node.js websites (`website_types=nodejs`). Combine with the other available query parameters to filter by username, order ID, enabled status, or domain name for more targeted results. A website appears in this list before its server-side setup has finished, and `is_enabled` reflects suspension, not readiness. To know when a newly created website is ready for file, deploy or database operations, poll the list website setups endpoint instead.

    GET /api/hosting/v1/websites

  • Write

    Start website setup

    Starts a website setup on a Web or Cloud hosting order and returns the created setup right away; the website itself is provisioned asynchronously. Poll the list website setups endpoint (`hosting_websites_list-setups`) with the `domain` filter every 10 to 15 seconds and wait for `status: completed` before uploading files, deploying or creating databases. Omit `type` for an empty website. `type: wordpress` installs WordPress in the website root with the admin user, email and password from `wordpress`, the domain as the site title, and `en_US` when `wordpress.language` is omitted. The headless types (`headless_empty`, `headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`) create a headless website; `headless_wordpress` additionally installs WordPress into the `cms` directory of the website root with generated credentials. `headless_empty` installs nothing: WordPress can be added later through `POST /api/hosting/v1/accounts/{username}/wordpress/installations` (`wordpress_installations_install`) with `type: headless`. Omit `domain` to set the website up on a generated temporary free subdomain. To know the free subdomain before the call, so a timed-out call can be looked up and retried on the same domain, generate one through `POST /api/hosting/v1/domains/free-subdomains` (`hosting_domains_generate-free-subdomain`) and send it as `domain`. It is accepted for 24 hours, only from the client that generated it. When the order has no hosting account yet, the setup creates one first, in the datacenter given by `datacenter_code` or the order's default datacenter when it is omitted. Returns 404 when the order does not exist or is not accessible to the authenticated client, and 409 with a `Retry-After` header while a setup for the same domain is still running.

    POST /api/hosting/v1/orders/{order_id}/onboardings

  • Write

    Create website (deprecated)

    Deprecated: use `POST /api/hosting/v1/orders/{order_id}/onboardings` (start website setup) instead. It takes the same `domain` and `datacenter_code`, can also install WordPress, and returns the created setup. Create a new website for the authenticated client. You must choose which hosting order to create this website on. Pass that order as `order_id` together with the domain name. List orders to see available IDs; the website is provisioned on that order's hosting plan. Only Web and Cloud hosting orders are accepted. To create a website on an Agency Plan order, use `POST /api/agency-hosting/v1/orders/{order_id}/websites/setups`. When the order has no hosting account yet, a new hosting account is set up first, in the datacenter given by `datacenter_code` or the order's default datacenter when it is omitted. Subsequent websites will be hosted on the same datacenter automatically. Website creation is asynchronous and takes up to a few minutes. Poll the list website setups endpoint with the `domain` filter every 10 to 15 seconds and wait for `status: completed` before uploading files, deploying or creating databases. While the setup is `running`, endpoints that operate on the website may respond with `404` or `409`. `is_enabled` on the websites list reflects suspension, not readiness.

    POST /api/hosting/v1/websites

  • Destructive

    Deploy static site archive

    Deploy a static application from an archive file. WARNING: this overwrites the website's existing contents and cannot be undone — verify this is intended before calling this endpoint. This endpoint allows you to deploy a static application from an archive file that has been uploaded to the website's directory. This only works for static sites (pre-built HTML/CSS/JS with no build step). For Node.js applications, use `Create NodeJS build from archive` instead, or `Start Node.js build` if the archive is already uploaded. For WordPress sites, use `Import WordPress website`.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/deploy

  • Destructive

    Delete website

    This endpoint permanently removes a website and all of its data. This action cannot be undone. Before calling it, make sure the user understands the consequences and explicitly confirms that they want to proceed. All website files, databases and related configuration will be removed. The hosting plan itself is kept, so a new website can be created on it afterwards. Supported websites: main and addon domain websites on web hosting plans, and Website Builder websites. Parked domains and subdomains cannot be deleted with this endpoint. The domain must be the exact website domain, not a preview domain or an alias. Returns 404 when the domain does not exist or does not belong to the authenticated client. Website removal is processed asynchronously and can take a few minutes to complete. The response returns before the removal finishes.

    DELETE /api/hosting/v1/websites/{domain}

Hosting: Orders

  • Read

    List orders

    Retrieve a paginated list of orders accessible to the authenticated client. Only Web and Cloud hosting orders are listed. Agency Plan orders are listed by `GET /api/agency-hosting/v1/orders`. This endpoint returns orders of your hosting accounts as well as orders of other client hosting accounts that have shared access with you. Use the available query parameters to filter results by order statuses or specific order IDs for more targeted results.

    GET /api/hosting/v1/orders

Hosting: PHP

  • Read

    Get PHP details

    Returns the full PHP configuration for the website: current version, available versions (supported and unsupported), enabled/disabled extensions, options with their current value, default, type and the plan limit (`max`), and conflicting extension groups. Use it to check the current PHP setup before updating the version, extensions or options.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/php/details

  • Read

    Get PHP info

    Returns the full phpinfo page (HTML) for the website. Use it to debug PHP issues or inspect the complete PHP environment of the website.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/php/php-info

  • Write

    Reset PHP extensions

    Resets all PHP extensions of the website to their default state. Use it to recover from extension conflicts or restore the original configuration.

    PATCH /api/hosting/v1/accounts/{username}/websites/{domain}/php/extensions/reset

  • Write

    Update PHP options

    Updates PHP options for the website (e.g. `memory_limit`, `max_execution_time`, `upload_max_filesize`). Only provide the options you want to change, inside the `options` object. Values above the account plan limit are silently capped to that limit, so the request can succeed with a smaller applied value. Call the Get PHP details endpoint afterwards to read the applied value.

    PATCH /api/hosting/v1/accounts/{username}/websites/{domain}/php/options

  • Write

    Update PHP version

    Changes the PHP version of the website. Use the Get PHP details endpoint to see the versions available for the website.

    PATCH /api/hosting/v1/accounts/{username}/websites/{domain}/php/version

  • Destructive

    Update PHP extensions

    Enables or disables PHP extensions (modules) for the website. Use the Get PHP details endpoint to check the current extension states before changing them.

    PATCH /api/hosting/v1/accounts/{username}/websites/{domain}/php/extensions

Hosting: Redirects

  • Read

    List website redirects

    Returns a paginated list of redirects configured for the selected website.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/redirects

  • Write

    Create website redirect

    Creates a redirect from a URL on the selected website to another URL or IP address.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/redirects

  • Destructive

    Delete website redirect

    Permanently deletes the redirect identified by its source URL. Pass the `from` value exactly as returned by the list redirects endpoint.

    DELETE /api/hosting/v1/accounts/{username}/websites/{domain}/redirects

Hosting: SSL

  • Read

    Get SSL status

    Returns the SSL state of the website: the certificate `status` and `provider`, whether the certificate is a lifetime one managed by the platform, whether HTTP requests are redirected to HTTPS, when the certificate stops being valid and the last installation error. `installing` and `waiting_for_retry` mean an installation is in progress. `failed` means the last installation gave up, or the website was not updated for 60 minutes while `installing`; `last_error` holds the reason when it is a known message, otherwise it is null. `expired` means the assigned certificate's validity has ended. `not_installed` means no certificate is assigned. Free subdomains use a platform-managed certificate: with no installation recorded they report `active` with `provider` and `expires_at` null.

    GET /api/hosting/v1/accounts/{username}/websites/{domain}/ssl/status

  • Write

    Install SSL

    Requests a lifetime SSL certificate for the website. The installation runs in the background; `Get SSL status` reports `active` or `failed` when it ends. An `active` lifetime certificate does not block the request: a new installation is requested, which is how a certificate is reinstalled. Returns 422 for free subdomains (their certificate is managed by the platform), while an installation is `installing` or `waiting_for_retry`, when the website's certificate was revoked (it cannot be reissued), and when an uploaded custom certificate is installed; that one has to be uninstalled first.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/ssl/setup

  • Destructive

    Toggle HTTPS redirect

    Turns the HTTP to HTTPS redirect of the website on or off, based on `is_enabled`. Does nothing when the redirect is already in the requested state. Turning it on requires an installed certificate (`status` `active` or `expired` on `Get SSL status`) and returns 422 when there is none; turning it off is always accepted.

    PATCH /api/hosting/v1/accounts/{username}/websites/{domain}/ssl/https-redirect/toggle

  • Destructive

    Uninstall SSL

    Removes the SSL certificate assigned to the website, turns the HTTPS redirect off and cancels a pending installation retry. The website serves plain HTTP until a new installation completes. `Get SSL status` reports `not_installed` as soon as the call returns; the call also succeeds when no certificate is assigned, so repeating it is safe. Returns 422 for free subdomains (their certificate is managed by the platform) and while an installation is `installing`.

    DELETE /api/hosting/v1/accounts/{username}/websites/{domain}/ssl

Mail: Aliases

  • Read

    List aliases

    Retrieve a paginated list of aliases across all mailboxes of a mail order.

    GET /api/mail/v1/orders/{orderId}/aliases

  • Write

    Create alias

    Create an alias for the given mailbox. The alias address is formed from the given local part and the domain of the mailbox. Messages sent to the alias are delivered to the mailbox.

    POST /api/mail/v1/mailboxes/{mailboxId}/aliases

  • Destructive

    Delete alias

    Delete an alias. Messages sent to the alias address are no longer delivered to the mailbox.

    DELETE /api/mail/v1/aliases/{aliasId}

Mail: API Tokens

  • Read

    List API tokens

    Retrieve a paginated list of [Hostinger Email API](https://api.mail.hostinger.com/) tokens across all your mail orders, optionally filtered by order. Plaintext tokens are never included; they are returned only when a token is created.

    GET /api/mail/v1/api-tokens

  • Write

    Create API token

    Create an API token for the given mail order. The token grants access to the [Hostinger Email API](https://api.mail.hostinger.com/), where you can provision and manage the mailboxes it is scoped to. The plaintext token is returned only in this response, never again. A maximum of 10 tokens can exist per order. Use `scope.has_all_mailboxes` to cover all current and future mailboxes, or list specific mailboxes in `scope.mailbox_ids`.

    POST /api/mail/v1/orders/{orderId}/api-tokens

  • Destructive

    Revoke API token

    Revoke an API token. The token immediately loses access to the [Hostinger Email API](https://api.mail.hostinger.com/). This action cannot be undone.

    DELETE /api/mail/v1/api-tokens/{tokenId}

Mail: Autoreplies

  • Read

    List autoreplies

    Retrieve a paginated list of autoreplies across all mailboxes of a mail order.

    GET /api/mail/v1/orders/{orderId}/autoreplies

  • Write

    Create autoreply

    Create an automatic reply for the given mailbox. A mailbox can have only one autoreply. Omit `starts_at` to activate the autoreply immediately and omit `ends_at` to keep it active indefinitely.

    POST /api/mail/v1/mailboxes/{mailboxId}/autoreplies

  • Destructive

    Update autoreply

    Replace the autoreply with the given content and schedule. Omitted optional fields are cleared: omit `starts_at` to activate the autoreply immediately and omit `ends_at` to keep it active indefinitely.

    PUT /api/mail/v1/autoreplies/{autoreplyId}

  • Destructive

    Delete autoreply

    Delete the autoreply of a mailbox. The mailbox stops sending automatic replies immediately.

    DELETE /api/mail/v1/autoreplies/{autoreplyId}

Mail: Catchalls

  • Read

    List catch-alls

    Retrieve a paginated list of catch-alls across all mailboxes of a mail order.

    GET /api/mail/v1/orders/{orderId}/catchalls

  • Write

    Create catch-all

    Create a catch-all that routes all messages sent to unknown addresses of the domain to the given mailbox. The mailbox address receives a confirmation email and the catch-all becomes active only after it is confirmed. A domain can have only one catch-all.

    POST /api/mail/v1/mailboxes/{mailboxId}/catchalls

  • Write

    Resend catch-all confirmation

    Resend the confirmation email to the mailbox address of an unconfirmed catch-all.

    POST /api/mail/v1/catchalls/{catchallId}/confirmation/resend

  • Destructive

    Delete catch-all

    Delete a catch-all. Messages sent to unknown addresses of the domain are no longer routed to the mailbox.

    DELETE /api/mail/v1/catchalls/{catchallId}

Mail: Forwarders

  • Read

    List forwarders

    Retrieve a paginated list of forwarders across all mailboxes of a mail order.

    GET /api/mail/v1/orders/{orderId}/forwarders

  • Write

    Create forwarder

    Create a forwarder from the given mailbox to the destination address. The destination receives a confirmation email and forwarding becomes active only after it is confirmed.

    POST /api/mail/v1/mailboxes/{mailboxId}/forwarders

  • Write

    Resend forwarder confirmation

    Resend the confirmation email to the destination address of an unconfirmed forwarder.

    POST /api/mail/v1/forwarders/{forwarderId}/confirmation/resend

  • Destructive

    Delete forwarder

    Delete a forwarder. The mailbox stops forwarding messages to the destination address immediately.

    DELETE /api/mail/v1/forwarders/{forwarderId}

  • Destructive

    Update forwarder keep-copy setting

    Enable or disable keeping a copy of forwarded messages in the mailbox.

    PATCH /api/mail/v1/forwarders/{forwarderId}/keep-copy

Mail: Logs

  • Read

    List access logs

    Retrieve paginated access logs for the domain attached to the given mail order. Supports filtering by account, date range, protocol, status, and deletion flag. Results are sorted by timestamp descending.

    GET /api/mail/v1/orders/{orderId}/logs/access

  • Read

    List action logs

    Retrieve paginated account action logs (administrative and user actions) for the given mail order. Supports filtering by account, date range, and status. Results are sorted by timestamp descending.

    GET /api/mail/v1/orders/{orderId}/logs/action

  • Read

    List inbound logs

    Retrieve paginated inbound (received mail) delivery logs for the domain attached to the given mail order. Supports filtering by account, date range, status, sender, and recipient. Results are sorted by timestamp descending.

    GET /api/mail/v1/orders/{orderId}/logs/inbound

  • Read

    List mailbox action logs

    Retrieve paginated mailbox action logs (message and mailbox events) for a mailbox in the given mail order. The mailbox email must belong to the order's domain. Supports date range and event type filters. Results are sorted by timestamp descending.

    GET /api/mail/v1/orders/{orderId}/logs/mailbox-actions

  • Read

    List outbound logs

    Retrieve paginated outbound (sent mail) delivery logs for the domain attached to the given mail order. Supports filtering by account, date range, status, sender, and recipient. Results are sorted by timestamp descending.

    GET /api/mail/v1/orders/{orderId}/logs/outbound

Mail: Mailboxes

  • Read

    List mailboxes

    Retrieve a paginated list of mailboxes belonging to a mail order. Use this endpoint to monitor mailboxes of your mail service, including their status, enabled protocols, attached resource counts, and periodically synced usage numbers (usage may lag behind live values).

    GET /api/mail/v1/orders/{orderId}/mailboxes

  • Write

    Create mailbox

    Create a mailbox under the given mail order. The full email address is composed from the given local part and the domain of the order.

    POST /api/mail/v1/orders/{orderId}/mailboxes

  • Write

    Change mailbox password

    Change the password of a mailbox.

    PATCH /api/mail/v1/mailboxes/{mailboxId}/password

  • Destructive

    Delete mailbox

    Delete a mailbox. The mailbox is soft-deleted and stays restorable for a limited period before it is permanently removed.

    DELETE /api/mail/v1/mailboxes/{mailboxId}

Mail: Orders

  • Read

    List orders

    Retrieve a paginated list of mail orders associated with your account. Use this endpoint to monitor your mail services, including their status, plan, attached domain, and expiration details.

    GET /api/mail/v1/orders

  • Read

    Get order plan

    Retrieve the plan the given mail order was purchased with, including domain-level and mailbox-level quotas, limits, and protocol availability.

    GET /api/mail/v1/orders/{orderId}/plan

Mail: Webhooks

  • Read

    List webhook delivery logs

    Retrieve a paginated list of webhook delivery logs for the given mail order, including delivery outcome, duration, and retry counts. Supports filtering by mailbox.

    GET /api/mail/v1/orders/{orderId}/webhooks/delivery-logs

  • Read

    Get webhook

    Retrieve the details of a single webhook. The webhook secret is never included; it is returned only when a webhook is created or its secret is regenerated.

    GET /api/mail/v1/webhooks/{webhookId}

  • Read

    List webhooks

    Retrieve a paginated list of webhooks belonging to the given mail order. Supports filtering by mailbox and status. The webhook secret is never included; it is returned only when a webhook is created or its secret is regenerated.

    GET /api/mail/v1/orders/{orderId}/webhooks

  • Write

    Create webhook

    Create a webhook for the given mailbox. The generated secret is returned only in this response and is sent as a bearer token with every delivery.

    POST /api/mail/v1/mailboxes/{mailboxId}/webhooks

  • Write

    Regenerate webhook secret

    Regenerate the secret of a webhook. The previous secret is immediately invalidated. The new secret is returned only in this response and is sent as a bearer token with every delivery.

    POST /api/mail/v1/webhooks/{webhookId}/regenerate-secret

  • Write

    Test webhook

    Send a test delivery to the webhook URL and return the result. Test requests are rate limited upstream.

    POST /api/mail/v1/webhooks/{webhookId}/test

  • Destructive

    Delete webhook

    Permanently delete a webhook. This action cannot be undone. After deletion the URL no longer receives event notifications.

    DELETE /api/mail/v1/webhooks/{webhookId}

  • Destructive

    Update webhook

    Partially update a webhook. Only the fields included in the request body are changed; omitted fields retain their current values. Pass `"description": null` to clear the description.

    PATCH /api/mail/v1/webhooks/{webhookId}

Reach: Automations

  • Read

    Get automation details

    Get a single automation with the counts of contacts that entered it, are moving through it, finished it or failed on the way. This describes the automation itself. To see the workflow it runs, use the steps endpoint.

    GET /api/reach/v1/profiles/{profileUuid}/automations/{automationUuid}

  • Read

    List automations

    Get a paginated list of the automations in a profile. Every automation comes with the counts of contacts that entered it, are moving through it, finished it or failed on the way. Those counts describe the contact journey and are not email engagement metrics - for opens, clicks and unsubscribes use the campaign statistics endpoint instead.

    GET /api/reach/v1/profiles/{profileUuid}/automations

  • Read

    List automation steps

    Get the workflow of an automation as a flat list of steps. The steps form a tree rather than a straight line: follow `parent_uuid` to reconstruct the branches, and use `step_order` to order the steps that share a parent. An automation with no steps yet returns an empty list.

    GET /api/reach/v1/profiles/{profileUuid}/automations/{automationUuid}/steps

Reach: Campaigns

  • Read

    Get campaign details

    Get a single campaign with its sender, subject, template reference, targeting and delivery progress. This describes how the campaign was set up and how far it has got. For opens, clicks and unsubscribes use the campaign statistics endpoint. The email content is not included: pass `template_uuid` to the get email template endpoint to read its HTML.

    GET /api/reach/v1/profiles/{profileUuid}/campaigns/{campaignUuid}

  • Read

    List campaigns

    Get a paginated list of the campaigns in a profile. Each campaign carries its headline engagement rates. Filter by status to find drafts, scheduled, sending or sent campaigns, keeping in mind that a fully sent campaign has the status `publish`. By default only regular campaigns are returned - pass `type` to get the emails sent by automations or the double opt-in confirmations instead.

    GET /api/reach/v1/profiles/{profileUuid}/campaigns

  • Read

    Get campaign performance

    Get the performance of a campaign: delivery, opens, clicks and unsubscribes, with the matching rates. Every count is unique contacts rather than raw events, so a contact who opens the same email five times is counted once.

    GET /api/reach/v1/profiles/{profileUuid}/campaigns/{campaignUuid}/statistics

  • Write

    Create a draft campaign

    Create a campaign in a profile. The campaign is created as a draft, so nothing is sent and no contact is touched. It has no audience yet either - targeting and scheduling are not part of this request, the draft is finished and sent from the Reach interface.

    POST /api/reach/v1/profiles/{profileUuid}/campaigns

Reach: Contacts

  • Read

    List contact groups (deprecated)

    Get a list of all contact groups. This endpoint returns a list of contact groups that can be used to organize contacts.

    GET /api/reach/v1/contacts/groups

  • Read

    List contacts (deprecated)

    Get a list of contacts, optionally filtered by group and subscription status. This endpoint returns a paginated list of contacts with their basic information. You can filter contacts by group UUID and subscription status. **Deprecated.** This endpoint cannot target a profile, so it always falls back to the client's default profile and cannot list contacts of any other profile. Use `GET /api/reach/v1/profiles/{profileUuid}/contacts` instead, which also replaces the group filter with a tag filter.

    GET /api/reach/v1/contacts

  • Read

    Get contact details

    Get the full details of a single contact. Alongside the contact's own attributes this returns the tags assigned to it and the values it holds for the profile's custom contact fields.

    GET /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}

  • Read

    List profile contacts

    Get a paginated list of contacts belonging to a profile. Contacts can be filtered by subscription status, by tag, and by an email search term. The `meta.total` field of the response is the number of contacts matching the filters, so calling this endpoint without filters gives the profile's total contact count.

    GET /api/reach/v1/profiles/{profileUuid}/contacts

  • Write

    Create a new contact (deprecated)

    Create a new contact in the email marketing system. This endpoint allows you to create a new contact with basic information like name, email, and surname. If double opt-in is enabled, the contact will be created with a pending status and a confirmation email will be sent.

    POST /api/reach/v1/contacts

  • Write

    Create contacts in bulk

    Create many contacts in a profile in a single call. The contacts are imported in the background, so a success response means the import was accepted rather than finished. Contacts whose email already exists in the profile keep their current values; only the ones that are still empty, custom fields included, are filled in. If double opt-in is enabled, new contacts start off pending and are sent a confirmation email.

    POST /api/reach/v1/profiles/{profileUuid}/contacts/bulk

  • Write

    Create new contacts

    Create a new contact in the email marketing system. This endpoint allows you to create a new contact with basic information like name, email, and surname. If double opt-in is enabled, the contact will be created with a pending status and a confirmation email will be sent.

    POST /api/reach/v1/profiles/{profileUuid}/contacts

  • Destructive

    Delete a contact (deprecated)

    Delete a contact with the specified UUID. This endpoint permanently removes a contact from the email marketing system. **Deprecated.** This endpoint cannot target a profile, so it always falls back to the client's default profile and cannot delete contacts of any other profile. Use `DELETE /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}` instead.

    DELETE /api/reach/v1/contacts/{uuid}

  • Destructive

    Delete a profile contact

    Permanently delete a contact from a profile. The contact is removed together with its custom field values and tag assignments.

    DELETE /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}

  • Destructive

    Update a contact

    Update a contact's attributes and custom field values. Only the properties present in the request body are changed, so a partial body is enough to change a single attribute. Sending a property as `null` clears it. The response carries the contact's core attributes. Read back its tags, custom field values, source and note with `GET /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}`.

    PATCH /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}

Reach: Contact Fields

  • Read

    List contact fields

    Get the custom contact fields defined in a profile. Custom fields let you store your own attributes on contacts. The returned uuids are what you pass to the contact update endpoint to set values, and choice fields also list the options available to pick from.

    GET /api/reach/v1/profiles/{profileUuid}/contacts/fields

  • Write

    Create a contact field

    Define a new custom contact field in a profile. The `slug` is derived from the label and, like the field type, cannot be changed later. Use the returned uuid to set values on contacts.

    POST /api/reach/v1/profiles/{profileUuid}/contacts/fields

  • Destructive

    Delete a contact field

    Delete a custom contact field. Every value contacts hold for the field is deleted with it, and for the choice types so are its options. The contacts themselves are not affected.

    DELETE /api/reach/v1/profiles/{profileUuid}/contacts/fields/{fieldUuid}

  • Destructive

    Update a contact field

    Rename a custom contact field and, for the choice types, replace its option set. Options carrying a uuid are kept and relabelled, options without one are created, and any existing option left out of the list is deleted along with the values contacts hold for it. The field type and slug cannot be changed.

    PATCH /api/reach/v1/profiles/{profileUuid}/contacts/fields/{fieldUuid}

Reach: Segments

  • Read

    List segments (deprecated)

    Get a list of all contact segments. This endpoint returns a list of contact segments that can be used to organize contacts. **Deprecated.** This endpoint cannot target a profile, so it always falls back to the client's default profile and cannot list the segments of any other profile. Use `GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments` instead.

    GET /api/reach/v1/segmentation/segments

  • Read

    Count profile segment contacts

    Count the contacts currently matching a segment without listing them. Cheaper than paging through the segment contacts endpoint when only the size is needed.

    GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/count

  • Read

    List profile segment contacts

    Retrieve contacts associated with a specific segment for a given profile. This endpoint allows you to fetch and filter contacts that belong to a particular segment, identified by its UUID, scoped to a specific profile.

    GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/contacts

  • Read

    Get profile segment details

    Get a single segment of a profile, including the conditions that define it. To retrieve the contacts currently matching those conditions, use the segment contacts endpoint instead.

    GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}

  • Read

    List segment filter attributes

    List every attribute a segment condition can filter on, with the operators each attribute accepts, the value format they expect and, where the value is constrained, the allowed values. The list is profile specific: it includes the profile's custom contact fields, its tags and its 20 most recently published campaigns, so the valid attributes cannot be hardcoded. Read it before creating or updating a segment to discover the valid `attribute`, `operator` and `value` combinations.

    GET /api/reach/v1/profiles/{profileUuid}/segmentation/filters/attributes

  • Read

    Preview contacts matching conditions

    Preview the contacts matching a set of conditions without saving a segment. The body is the same set of conditions accepted when creating or updating a segment, so this is how to check who a filter reaches, and how many, before persisting it. Nothing is stored and no contact is modified. Call the segment filter attributes endpoint first to discover the valid `attribute`, `operator` and `value` combinations.

    POST /api/reach/v1/profiles/{profileUuid}/segmentation/filters/contacts

  • Read

    List profile segments

    Get a paginated list of the segments defined in a profile. Each entry carries the number of contacts currently matching it, which is recalculated on read rather than stored. Use `count_type` to count either every matching contact or only the subscribed ones.

    GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments

  • Read

    List segment contacts (deprecated)

    Retrieve contacts associated with a specific segment. This endpoint allows you to fetch and filter contacts that belong to a particular segment, identified by its UUID. **Deprecated.** This endpoint cannot target a profile, so it always falls back to the client's default profile and cannot read segments of any other profile. Use `GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/contacts` instead.

    GET /api/reach/v1/segmentation/segments/{segmentUuid}/contacts

  • Read

    Get segment details (deprecated)

    Get details of a specific segment. This endpoint retrieves information about a single segment identified by UUID. Segments are used to organize and group contacts based on specific criteria. **Deprecated.** This endpoint cannot target a profile, so it always falls back to the client's default profile and cannot read segments of any other profile. Use `GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}` instead.

    GET /api/reach/v1/segmentation/segments/{segmentUuid}

  • Write

    Create a new contact segment (deprecated)

    Create a new contact segment. This endpoint allows creating a new contact segment that can be used to organize contacts. The segment can be configured with specific criteria like email, name, subscription status, etc. **Deprecated.** This endpoint cannot target a profile, so it always falls back to the client's default profile and cannot create segments in any other profile. Use `POST /api/reach/v1/profiles/{profileUuid}/segmentation/segments` instead.

    POST /api/reach/v1/segmentation/segments

  • Write

    Create a profile segment

    Create a segment in a profile. A segment is a saved set of conditions rather than a fixed list, so its membership changes as contacts change. Creating one does not modify any contact.

    POST /api/reach/v1/profiles/{profileUuid}/segmentation/segments

  • Destructive

    Update a profile segment

    Rename a segment and/or replace the conditions that define it. `name` is always required. Omit `conditions` to rename without touching the conditions; supply them and they replace the existing set entirely rather than being merged into it. Contacts are never modified, but which of them match the segment can change immediately.

    PUT /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}

  • Destructive

    Delete a profile segment

    Delete a segment. Only the segment definition is removed. The contacts that matched it are left untouched.

    DELETE /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}

Reach: Tags

  • Read

    List profile tags

    Get all tags defined in a profile. Tags are the way contacts are grouped in Reach, and can be used to filter the contact list or to build segments.

    GET /api/reach/v1/profiles/{profileUuid}/tags

  • Write

    Assign a contact to a tag

    Assign a tag to a single contact. Unlike the bulk endpoint this is applied immediately rather than queued. Assigning a tag the contact already carries succeeds without duplicating it.

    POST /api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts/{contactUuid}

  • Write

    Assign contacts to a tag

    Assign a tag to many contacts at once. Pass `contact_uuids` to target specific contacts, or `all_contacts` to target every contact in the profile. The work is queued, so a success response means it was accepted rather than finished. Contacts that already carry the tag are left alone.

    POST /api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts

  • Write

    Rename a tag

    Rename a tag. The contacts assigned to the tag are unaffected. Names are unique within a profile, so renaming a tag to a name that is already taken is rejected.

    PATCH /api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}

  • Write

    Create or find tags

    Create tags in a profile. Names that already exist in the profile are not duplicated: the existing tag is returned instead, so the call is safe to repeat. Every tag in the request is returned, whether it was created now or already existed.

    POST /api/reach/v1/profiles/{profileUuid}/tags

  • Destructive

    Remove a contact from a tag

    Remove a tag from a single contact. Unlike the bulk endpoint this is applied immediately rather than queued. Neither the tag nor the contact is deleted.

    DELETE /api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts/{contactUuid}

  • Destructive

    Remove contacts from a tag

    Remove a tag from many contacts at once. Pass `contact_uuids` to target specific contacts, or `all_contacts` to target every contact in the profile. The work is queued, so a success response means it was accepted rather than finished. The tag itself and the contacts are not deleted.

    DELETE /api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts

  • Destructive

    Delete a tag

    Delete a tag and remove it from every contact carrying it. The contacts themselves are not deleted. This is idempotent: deleting a tag that does not exist in the profile still succeeds.

    DELETE /api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}

Reach: Forms

  • Read

    Get form details

    Get a single form with the URL of its hosted template and the tags it applies to the contacts it captures. There is no ready-made embed snippet in the response - either serve the template HTML yourself or build your own embed around the form uuid.

    GET /api/reach/v1/profiles/{profileUuid}/forms/{formUuid}

  • Read

    List forms

    Get a paginated list of the signup forms in a profile. Each form carries a reference to the template that renders it. Get the form details for a directly usable template URL and for the tags the form puts on the contacts it captures.

    GET /api/reach/v1/profiles/{profileUuid}/forms

  • Write

    Duplicate form

    Copy a form into a new draft form with the same name and design. The copy shares the source's automatic `form:{name}` tag; other submitter tags are not copied. The copy is not live until its status is set to `active`.

    POST /api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/duplicate

  • Write

    Create form

    Create an empty draft form. Reach also adds an automatic `form:{name}` tag that every submitter receives. A draft has no design and is not reachable by visitors: save a design with the update form template operation, then take the form live by setting its status to `active`. Creating a form does not consume AI credits.

    POST /api/reach/v1/profiles/{profileUuid}/forms

  • Write

    Add form submitter tags

    Add tags to a form so that every contact who submits it from now on receives them. A tag the form already has is skipped; an unknown tag is rejected. Contacts who submitted earlier are not tagged.

    POST /api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/tags

  • Destructive

    Delete form

    Permanently delete a form together with its template. A form that has already captured submissions cannot be deleted, so that the contacts it collected are never silently discarded - pause the form instead to stop it collecting new ones. Views alone do not block deletion.

    DELETE /api/reach/v1/profiles/{profileUuid}/forms/{formUuid}

  • Destructive

    Update form

    Rename a form and/or change its status. Setting a `draft` or `paused` form to `active` takes it live: its latest saved design is published and visitors can submit it. `paused` and `draft` stop the form from accepting submissions. A form is not reachable by visitors until it is taken live. Design changes saved while the form is already `active` stay unpublished until the form is paused and set to `active` again. Renaming does not rename the automatic `form:{name}` tag.

    PATCH /api/reach/v1/profiles/{profileUuid}/forms/{formUuid}

  • Destructive

    Remove form submitter tag

    Stop a form from applying a tag to its future submitters. Succeeds also when the form did not have the tag. Contacts who already received the tag keep it, and the tag itself is not deleted. The automatic `form:{name}` tag cannot be removed and is rejected with a conflict.

    DELETE /api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/tags

  • Destructive

    Update form template

    Save `content` as the latest design of a form and return the stored version. The HTML is sanitized and, unless the plan allows removing it, the Reach signature is added. Visitors submit the form with an `email` field (required) and optional `name`, `surname` and `phone`. After sanitizing, the design must contain a form container (`data-reach-form`), an email input (`data-reach-field="email"`) and a submit button (`data-reach-submit`); otherwise the request fails with `422` and `errors.content` lists `missing_form_container`, `missing_email_field` and/or `missing_submit_button`. A `draft` or `paused` form stays unreachable until its status is set to `active`, which publishes this design. On a form that is already `active` the saved design is not public until the form is paused and set to `active` again. Saving a design does not consume AI credits.

    PATCH /api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/template

Reach: Profiles

  • Read

    Get connected sending domain

    Get the sending domain connected to the profile, its verification status and any suspended sender addresses. Campaigns only go out once a domain is connected and active, so this is the cheapest way to check that precondition before building one. A profile with no domain connected returns the same shape with every field set to `null`. For the individual MX, SPF, DKIM and DMARC records behind the status, use the DNS status endpoint.

    GET /api/reach/v1/profiles/{profileUuid}/domains

  • Read

    Get profile domain DNS status

    Retrieve the DNS configuration status for a profile's domain. This endpoint reports the state of MX, SPF, DKIM and DMARC records, including the actual records found and the suggested records required for correct email delivery.

    GET /api/reach/v1/profiles/{profileUuid}/domains/dns-status

  • Read

    List plan feature access

    List which plan features the profile can use. This is the feature lock matrix, not a usage quota. `available` means the feature can be used right now and `locked` means it is not part of the base plan, so an upgrade is needed. For remaining emails, recipients and AI credits use the limits endpoint instead. Worth checking before building something that cannot be activated afterwards, such as an automation on a plan without automation activation.

    GET /api/reach/v1/profiles/{profileUuid}/features

  • Read

    Get remaining plan limits

    Get how much of the plan is left for the current period. Two things to keep in mind before you build alerting on this. The period is a calendar month rather than a billing anniversary, so the counters reset on the 1st no matter when the subscription started. And usage is tracked per order, so every profile on the same order shares one pool and reports the same numbers here. Only the current period is available, past usage is not kept.

    GET /api/reach/v1/profiles/{profileUuid}/limits

  • Read

    List Profiles

    This endpoint returns all profiles available to the client, including their basic information.

    GET /api/reach/v1/profiles

  • Read

    Get profile settings

    Get the profile's saved sender identity and brand details. Read the default sender before creating a campaign instead of asking the customer, and reuse the brand fields when generating email content. Any field can be `null` for a profile that never filled its settings in. This does not check that the sending domain is verified, use the connected sending domain endpoint for that.

    GET /api/reach/v1/profiles/{profileUuid}/settings

  • Write

    Connect sending domain

    Connect a sending domain to the profile so emails can be sent from addresses on it. Connecting does not make the domain ready to send: check the DNS status endpoint next for records that are still missing. A domain the account owns or has already verified connects immediately. Any other domain starts a TXT ownership verification and returns `409`; complete the verification in Reach, then retry. Returns `422` when the profile or another profile already has the domain, the domain is blocked, or its ownership cannot be verified. An already connected domain is never replaced. On success the sender address of draft and scheduled campaigns, and of published automation and double opt-in emails, moves onto the new domain in the background, keeping the part before the `@`.

    POST /api/reach/v1/profiles/{profileUuid}/domains

  • Destructive

    Delete sending domain

    Disconnect the sending domain from the profile. The domain record is removed, so the profile has no sending domain afterwards and campaigns cannot be sent until a domain is connected again. Sender addresses already stored on campaigns, automations and settings are left untouched and keep pointing at the removed domain. A domain that is not connected to the profile also succeeds, so success is not proof that anything was deleted. DNS records at the DNS provider are not removed. To switch domains, delete this one and connect the new one. Confirm the domain with the customer before calling.

    DELETE /api/reach/v1/profiles/{profileUuid}/domains

  • Destructive

    Update profile settings

    Change the profile's default sender and brand details. Send only the fields to change: every omitted field keeps its value, and `null` or an empty string clears a text field. The default sender is what campaigns created afterwards start from; existing campaigns keep their own sender. `sender_email` is only the part before the `@`, because Reach combines it with the profile's connected sending domain, so an address outside that domain cannot be set. Connecting a sending domain is a separate endpoint and a connected domain cannot be changed here. Returns the settings after the change.

    PATCH /api/reach/v1/profiles/{profileUuid}/settings

Reach: Integrations

  • Read

    List Ecommerce stores

    Get all of the customer's Hostinger eCommerce stores, each with its `store_id` and `connection_status` for the profile in the path. A store is connected to at most one profile. `connected_to_other_profile` does not name that profile - call this for each profile to find it. The list is empty, not an error, when the eCommerce service cannot be reached. Pass `store_id` to the connect or disconnect eCommerce store endpoint.

    GET /api/reach/v1/profiles/{profileUuid}/ecommerce/stores

  • Read

    List connected websites

    Get the websites connected to the profile, each with its `domain` and `platform_type`. A domain is connected to at most one profile, so to find which plan a site is on, call this for each profile. Only connected sites are listed, not every website the customer owns, and eCommerce stores are not included - use the list eCommerce stores endpoint for those. Pass `domain` to the disconnect WordPress site or disconnect AI Website Builder site endpoint.

    GET /api/reach/v1/profiles/{profileUuid}/websites

  • Write

    Connect Ecommerce store

    Connect one of the customer's eCommerce stores to the profile, so Reach receives its customers and orders. Take `store_id` from the list eCommerce stores endpoint. Fails with not found (`ECOMMERCE_STORE_NOT_FOUND`) when the store is not one of the customer's own stores, also when the eCommerce service cannot be reached. Fails with a conflict (`ECOMMERCE_CONNECTION_ALREADY_EXISTS`) when the store is connected to any profile or this profile already has a store - to move a store to another plan, disconnect it from the profile that holds it first.

    POST /api/reach/v1/profiles/{profileUuid}/ecommerce/stores/{storeId}

  • Write

    Connect AI Website Builder site

    Connect an AI Website Builder site the customer built manually to the profile, so its subscribers flow into Reach. Fails with not found when the customer owns no AI Website Builder site with that domain. Fails with `DOMAIN_ALREADY_EXISTS` when the domain is connected to any profile - to move a site to another plan, disconnect it from the old profile first - and with `WEBSITE_CONNECTION_ALREADY_EXISTS` when this profile already has an AI Website Builder site. The eCommerce store selling on the site, if it is not connected anywhere, is connected too. WordPress sites and sites made with the agentic AI Website Builder cannot be connected here.

    POST /api/reach/v1/profiles/{profileUuid}/websites/website-builder

  • Destructive

    Disconnect Ecommerce store

    Disconnect an eCommerce store from the profile. Reach stops receiving the store's customers and orders, and its products and coupons are removed from Reach; contacts and past orders stay. Take `store_id` from the list eCommerce stores endpoint; for a store that is `connected_to_other_profile`, call this with that profile. Also succeeds when the store is not connected to this profile, so success is not proof that anything was disconnected. To move the store to another plan, connect it to the new profile afterwards. Confirm the store and the plan with the customer before calling.

    DELETE /api/reach/v1/profiles/{profileUuid}/ecommerce/stores/{storeId}

  • Destructive

    Disconnect AI Website Builder site

    Disconnect an AI Website Builder site from the profile; the site stops sending subscribers to Reach. Take `domain` from the list connected websites endpoint. Works for a site that was already deleted in the builder. Fails with not found when the domain is not connected to this profile. Contacts and any connected eCommerce store stay. The site stays disconnected until it is connected again, so confirm the site and the plan with the customer before calling.

    DELETE /api/reach/v1/profiles/{profileUuid}/websites/website-builder

  • Destructive

    Disconnect WordPress site

    Disconnect a WordPress site from the profile. The Reach plugin on the site stops sending subscribers and store data, and the site's products and coupons are removed from Reach; contacts and past orders stay. Take `domain` from the list connected websites endpoint. Fails with not found when the domain is not connected to this profile. This cannot be undone through the API - the customer reconnects from the WordPress plugin - so confirm the site and the plan with the customer before calling.

    DELETE /api/reach/v1/profiles/{profileUuid}/websites/wordpress

Reach: Templates

  • Read

    List email templates

    Get a list of the email templates in a profile, most recently updated first. Templates are the reusable email bodies a campaign is built from. The list is not paginated and only the metadata is returned, without the HTML content. Use the `uuid` of a template as the `template_uuid` when creating a campaign. To read one template's HTML use the get email template endpoint, and only when the content itself is needed.

    GET /api/reach/v1/profiles/{profileUuid}/templates

  • Read

    Get email template

    Get one email template of the profile with its full HTML in `template_content`. A campaign's email content is its template: to read what a campaign sends, get the campaign and pass its `template_uuid` here. The HTML can be large, so fetch it only when the content itself is needed, never to browse or pick templates - the list email templates endpoint does that without content. Personalization tags such as `{{name}}` come back unrendered.

    GET /api/reach/v1/profiles/{profileUuid}/templates/{templateUuid}

  • Write

    Create an email template

    Create an email template in a profile. The template holds the HTML body a campaign reuses, so it can be created before any campaign exists. Only the template metadata comes back - keep the returned `uuid` to reference it as the `template_uuid` of a campaign.

    POST /api/reach/v1/profiles/{profileUuid}/templates

VPS: Data centers

  • Read

    Get data center list

    Retrieve all available data centers. Use this endpoint to view location options before deploying VPS instances.

    GET /api/vps/v1/data-centers

VPS: Docker Manager

  • Read

    Get project containers

    Retrieves a list of all containers belonging to a specific Docker Compose project on the virtual machine. This endpoint returns detailed information about each container including their current status, port mappings, and runtime configuration. Use this to monitor the health and state of all services within your Docker Compose project.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/containers

  • Read

    Get project contents

    Retrieves the complete project information including the docker-compose.yml file contents, project metadata, and current deployment status. This endpoint provides the full configuration and state details of a specific Docker Compose project. Use this to inspect project settings, review the compose file, or check the overall project health.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}

  • Read

    Get project list

    Retrieves a list of all Docker Compose projects currently deployed on the virtual machine. This endpoint returns basic information about each project including name, status, file path and list of containers with details about their names, image, status, health and ports. Container stats are omitted in this endpoint. If you need to get detailed information about container with stats included, use the `Get project containers` endpoint. Use this to get an overview of all Docker projects on your VPS instance.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/docker

  • Read

    Get project logs

    Retrieves aggregated log entries from all services within a Docker Compose project. This endpoint returns recent log output from each container, organized by service name with timestamps. The response contains the last 300 log entries across all services. Use this for debugging, monitoring application behavior, and troubleshooting issues across your entire project stack.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/logs

  • Write

    Create new project

    Deploy new project from docker-compose.yaml contents or download contents from URL. URL can be Github repository url in format https://github.com/[user]/[repo] and it will be automatically resolved to docker-compose.yaml file in master branch. Any other URL provided must return docker-compose.yaml file contents. If project with the same name already exists, existing project will be replaced.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/docker

  • Write

    Restart project

    Restarts all services in a Docker Compose project by stopping and starting containers in the correct dependency order. This operation preserves data volumes and network configurations while refreshing the running containers. Use this to apply configuration changes or recover from service failures.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/restart

  • Write

    Start project

    Starts all services in a Docker Compose project that are currently stopped. This operation brings up containers in the correct dependency order as defined in the compose file. Use this to resume a project that was previously stopped or to start services after a system reboot.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/start

  • Write

    Update project

    Updates a Docker Compose project by pulling the latest image versions and recreating containers with new configurations. This operation preserves data volumes while applying changes from the compose file. Use this to deploy application updates, apply configuration changes, or refresh container images to their latest versions.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/update

  • Destructive

    Delete project

    Completely removes a Docker Compose project from the virtual machine, stopping all containers and cleaning up associated resources including networks, volumes, and images. This operation is irreversible and will delete all project data. Use this when you want to permanently remove a project and free up system resources.

    DELETE /api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/down

  • Destructive

    Stop project

    Stops all running services in a Docker Compose project while preserving container configurations and data volumes. This operation gracefully shuts down containers in reverse dependency order. Use this to temporarily halt a project without removing data or configurations.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/docker/{projectName}/stop

VPS: Firewall

  • Read

    Get firewall details

    Retrieve firewall by its ID and rules associated with it. Use this endpoint to view specific firewall configuration and rules.

    GET /api/vps/v1/firewall/{firewallId}

  • Read

    Get firewall list

    Retrieve all available firewalls. Use this endpoint to view existing firewall configurations.

    GET /api/vps/v1/firewall

  • Write

    Activate firewall

    Activate a firewall for a specified virtual machine. Only one firewall can be active for a virtual machine at a time. Use this endpoint to apply firewall rules to VPS instances.

    POST /api/vps/v1/firewall/{firewallId}/activate/{virtualMachineId}

  • Write

    Create new firewall

    Create a new firewall. Use this endpoint to set up new firewall configurations for VPS security.

    POST /api/vps/v1/firewall

  • Write

    Update firewall rule

    Update a specific firewall rule from a specified firewall. Any virtual machine that has this firewall activated will lose sync with the firewall and will have to be synced again manually. Use this endpoint to modify existing firewall rules.

    PUT /api/vps/v1/firewall/{firewallId}/rules/{ruleId}

  • Write

    Create firewall rule

    Create new firewall rule for a specified firewall. By default, the firewall drops all incoming traffic, which means you must add accept rules for all ports you want to use. Any virtual machine that has this firewall activated will lose sync with the firewall and will have to be synced again manually. Use this endpoint to add new security rules to firewalls.

    POST /api/vps/v1/firewall/{firewallId}/rules

  • Write

    Sync firewall to all assigned VMs

    Sync a firewall's rules to every virtual machine it's assigned to. Firewall can lose sync with a virtual machine if the firewall has new rules added, removed or updated. Use this endpoint to apply updated firewall rules to all VPS instances assigned to the firewall.

    POST /api/vps/v1/firewall/{firewallId}/sync

  • Write

    Sync firewall (deprecated)

    Deprecated: use `POST /api/vps/v1/firewall/{firewallId}/sync` instead, which syncs the firewall to all virtual machines assigned to it. Sync a firewall for a specified virtual machine. Firewall can lose sync with virtual machine if the firewall has new rules added, removed or updated. Use this endpoint to apply updated firewall rules to VPS instances.

    POST /api/vps/v1/firewall/{firewallId}/sync/{virtualMachineId}

  • Destructive

    Deactivate firewall

    Deactivate a firewall for a specified virtual machine. Use this endpoint to remove firewall protection from VPS instances.

    POST /api/vps/v1/firewall/{firewallId}/deactivate/{virtualMachineId}

  • Destructive

    Delete firewall

    Delete a specified firewall. Any virtual machine that has this firewall activated will automatically have it deactivated. Use this endpoint to remove unused firewall configurations.

    DELETE /api/vps/v1/firewall/{firewallId}

  • Destructive

    Delete firewall rule

    Delete a specific firewall rule from a specified firewall. Any virtual machine that has this firewall activated will lose sync with the firewall and will have to be synced again manually. Use this endpoint to remove specific firewall rules.

    DELETE /api/vps/v1/firewall/{firewallId}/rules/{ruleId}

  • Destructive

    Replace all firewall rules in group

    Replaces all firewall rules within a specified firewall group with the provided set of rules in a single atomic operation, instead of creating or deleting rules one by one. Any virtual machine using this firewall group will need to be synchronized after replacing rules; pass the "sync" parameter to trigger synchronization immediately.

    PUT /api/vps/v1/firewall/{firewallId}/rules

VPS: Post-install scripts

  • Read

    Get post-install script

    Retrieve post-install script by its ID. Use this endpoint to view specific automation script details.

    GET /api/vps/v1/post-install-scripts/{postInstallScriptId}

  • Read

    Get post-install scripts

    Retrieve post-install scripts associated with your account. Use this endpoint to view available automation scripts for VPS deployment.

    GET /api/vps/v1/post-install-scripts

  • Write

    Update post-install script

    Update a specific post-install script. Use this endpoint to modify existing automation scripts.

    PUT /api/vps/v1/post-install-scripts/{postInstallScriptId}

  • Write

    Create post-install script

    Add a new post-install script to your account, which can then be used after virtual machine installation. The script contents will be saved to the file `/post_install` with executable attribute set and will be executed once virtual machine is installed. The output of the script will be redirected to `/post_install.log`. Maximum script size is 48KB. Use this endpoint to create automation scripts for VPS setup tasks.

    POST /api/vps/v1/post-install-scripts

  • Destructive

    Delete post-install script

    Delete a post-install script from your account. Use this endpoint to remove unused automation scripts.

    DELETE /api/vps/v1/post-install-scripts/{postInstallScriptId}

VPS: Public Keys

  • Read

    Get public keys (deprecated)

    Deprecated: account-level public keys have no direct replacement. Root SSH keys are now managed per virtual machine via `GET /api/vps/v1/virtual-machines/{virtualMachineId}/ssh-keys`. Retrieve public keys associated with your account. Use this endpoint to view available SSH keys for VPS authentication.

    GET /api/vps/v1/public-keys

  • Write

    Attach public key (deprecated)

    Deprecated: use `POST /api/vps/v1/virtual-machines/{virtualMachineId}/ssh-keys` instead. Attach existing public keys from your account to a specified virtual machine. Multiple keys can be attached to a single virtual machine. Use this endpoint to enable SSH key authentication for VPS instances.

    POST /api/vps/v1/public-keys/attach/{virtualMachineId}

  • Write

    Create public key (deprecated)

    Deprecated: account-level public keys have no direct replacement. Root SSH keys are now managed per virtual machine via `POST /api/vps/v1/virtual-machines/{virtualMachineId}/ssh-keys`. Add a new public key to your account. Use this endpoint to register SSH keys for VPS authentication.

    POST /api/vps/v1/public-keys

  • Destructive

    Delete public key (deprecated)

    Deprecated: account-level public keys have no direct replacement. Root SSH keys are now managed per virtual machine via `DELETE /api/vps/v1/virtual-machines/{virtualMachineId}/ssh-keys`. Delete a public key from your account. **Deleting public key from account does not remove it from virtual machine** Use this endpoint to remove unused SSH keys from account.

    DELETE /api/vps/v1/public-keys/{publicKeyId}

VPS: SSH Keys

  • Read

    List virtual machine SSH keys

    Retrieve SSH public keys currently configured on a specified virtual machine. Only keys of the `root` user are listed. Use this endpoint to view SSH keys that can be used for authentication on VPS instances.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/ssh-keys

  • Write

    Add virtual machine SSH keys

    Add one or more SSH public keys to a specified virtual machine. Keys are added to the `root` user and can be used for passwordless SSH authentication. Returns the complete list of SSH keys currently configured on the virtual machine. Use this endpoint to enable SSH key authentication for VPS instances.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/ssh-keys

  • Destructive

    Remove virtual machine SSH keys

    Remove one or more SSH public keys from a specified virtual machine. Removed keys can no longer be used to authenticate via SSH as the `root` user. Returns the remaining list of SSH keys configured on the virtual machine. Use this endpoint to revoke SSH key access to VPS instances.

    DELETE /api/vps/v1/virtual-machines/{virtualMachineId}/ssh-keys

VPS: OS Templates

  • Read

    Get template details

    Retrieve detailed information about a specific OS template for virtual machines. Use this endpoint to view specific template specifications before deployment.

    GET /api/vps/v1/templates/{templateId}

  • Read

    Get templates

    Retrieve available OS templates for virtual machines. Use this endpoint to view operating system options before creating or recreating VPS instances.

    GET /api/vps/v1/templates

VPS: Actions

  • Read

    Get action details

    Retrieve detailed information about a specific action performed on a specified virtual machine. Use this endpoint to monitor specific VPS operation status and details.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/actions/{actionId}

  • Read

    Get actions

    Retrieve actions performed on a specified virtual machine. Actions are operations or events that have been executed on the virtual machine, such as starting, stopping, or modifying the machine. This endpoint allows you to view the history of these actions, providing details about each action, such as the action name, timestamp, and status. Use this endpoint to view VPS operation history and troubleshoot issues.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/actions

VPS: Virtual machine

  • Read

    Get attached public keys (deprecated)

    Deprecated: use `GET /api/vps/v1/virtual-machines/{virtualMachineId}/ssh-keys` instead. Retrieve public keys attached to a specified virtual machine. Use this endpoint to view SSH keys configured for specific VPS instances.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/public-keys

  • Read

    Get virtual machine details

    Retrieve detailed information about a specified virtual machine. Use this endpoint to view comprehensive VPS configuration and status.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}

  • Read

    Get virtual machines

    Retrieve all available virtual machines. Use this endpoint to view available VPS instances.

    GET /api/vps/v1/virtual-machines

  • Read

    Get metrics

    Retrieve historical metrics for a specified virtual machine. It includes the following metrics: - CPU usage - Memory usage - Disk usage - Network usage - Uptime Use this endpoint to monitor VPS performance and resource utilization over time.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/metrics

  • Write

    Set hostname

    Set hostname for a specified virtual machine. Changing hostname does not update PTR record automatically. If you want your virtual machine to be reachable by a hostname, you need to point your domain A/AAAA records to virtual machine IP as well. Use this endpoint to configure custom hostnames for VPS instances.

    PUT /api/vps/v1/virtual-machines/{virtualMachineId}/hostname

  • Write

    Purchase new virtual machine

    Purchase and setup a new virtual machine. If virtual machine setup fails for any reason, login to [hPanel](https://hpanel.hostinger.com/) and complete the setup manually. If no payment method is provided, your default payment method will be used automatically. If the response is `202 Accepted`, the payment is still being processed and the virtual machine was not set up. Login to [hPanel](https://hpanel.hostinger.com/) and complete the setup manually. Use this endpoint to create new VPS instances.

    POST /api/vps/v1/virtual-machines

  • Write

    Set nameservers

    Set nameservers for a specified virtual machine. Be aware, that improper nameserver configuration can lead to the virtual machine being unable to resolve domain names. Use this endpoint to configure custom DNS resolvers for VPS instances.

    PUT /api/vps/v1/virtual-machines/{virtualMachineId}/nameservers

  • Write

    Set panel password

    Set panel password for a specified virtual machine. If virtual machine does not use panel OS, the request will still be processed without any effect. Requirements for password are same as in the [recreate virtual machine endpoint](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines/{virtualMachineId}/recreate). Use this endpoint to configure control panel access credentials for VPS instances.

    PUT /api/vps/v1/virtual-machines/{virtualMachineId}/panel-password

  • Write

    Set root password

    Set root password for a specified virtual machine. Requirements for password are same as in the [recreate virtual machine endpoint](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines/{virtualMachineId}/recreate). Use this endpoint to update administrator credentials for VPS instances.

    PUT /api/vps/v1/virtual-machines/{virtualMachineId}/root-password

  • Write

    Setup purchased virtual machine

    Setup newly purchased virtual machine with `initial` state. Use this endpoint to configure and initialize purchased VPS instances.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/setup

  • Write

    Start virtual machine

    Start a specified virtual machine. If the virtual machine is already running, the request will still be processed without any effect. Use this endpoint to power on stopped VPS instances.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/start

  • Destructive

    Reset hostname

    Reset hostname and PTR record of a specified virtual machine to default value. Use this endpoint to restore default hostname configuration for VPS instances.

    DELETE /api/vps/v1/virtual-machines/{virtualMachineId}/hostname

  • Destructive

    Recreate virtual machine

    Recreate a virtual machine from scratch. The recreation process involves reinstalling the operating system and resetting the virtual machine to its initial state. Snapshots, if there are any, will be deleted. ## Password Requirements Password will be checked against leaked password databases. Requirements for the password are: - At least 12 characters long - At least one uppercase letter - At least one lowercase letter - At least one number - Is not leaked publicly **This operation is irreversible and will result in the loss of all data stored on the virtual machine!** Use this endpoint to completely rebuild VPS instances with fresh OS installation.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/recreate

  • Destructive

    Restart virtual machine

    Restart a specified virtual machine by fully stopping and starting it. If the virtual machine was stopped, it will be started. Use this endpoint to reboot VPS instances.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/restart

  • Destructive

    Stop virtual machine

    Stop a specified virtual machine. If the virtual machine is already stopped, the request will still be processed without any effect. This is a compute-only power state change and does not affect billing. To stop future charges, disable auto-renewal on the owning subscription. Use this endpoint to power off running VPS instances.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/stop

VPS: Backups

  • Read

    Get backups

    Retrieve backups for a specified virtual machine. Use this endpoint to view available backup points for VPS data recovery.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/backups

  • Destructive

    Restore backup

    Restore a backup for a specified virtual machine. The system will then initiate the restore process, which may take some time depending on the size of the backup. **All data on the virtual machine will be overwritten with the data from the backup.** Use this endpoint to recover VPS data from backup points.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/backups/{backupId}/restore

VPS: Malware scanner

  • Read

    Get scan metrics

    Retrieve scan metrics for the [Monarx](https://www.monarx.com/) malware scanner installed on a specified virtual machine. The scan metrics provide detailed information about malware scans performed by Monarx, including number of scans, detected threats, and other relevant statistics. This information is useful for monitoring security status of the virtual machine and assessing effectiveness of the malware scanner. Use this endpoint to monitor VPS security scan results and threat detection.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/monarx

  • Write

    Install Monarx

    Install the Monarx malware scanner on a specified virtual machine. [Monarx](https://www.monarx.com/) is a security tool designed to detect and prevent malware infections on virtual machines. By installing Monarx, users can enhance the security of their virtual machines, ensuring that they are protected against malicious software. Use this endpoint to enable malware protection on VPS instances.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/monarx

  • Destructive

    Uninstall Monarx

    Uninstall the Monarx malware scanner on a specified virtual machine. If Monarx is not installed, the request will still be processed without any effect. Use this endpoint to remove malware scanner from VPS instances.

    DELETE /api/vps/v1/virtual-machines/{virtualMachineId}/monarx

VPS: PTR records

  • Write

    Create PTR record

    Create or update a PTR (Pointer) record for a specified virtual machine. Use this endpoint to configure reverse DNS lookup for VPS IP addresses.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/ptr/{ipAddressId}

  • Destructive

    Delete PTR record

    Delete a PTR (Pointer) record for a specified virtual machine. Once deleted, reverse DNS lookups to the virtual machine's IP address will no longer return the previously configured hostname. Use this endpoint to remove reverse DNS configuration from VPS instances.

    DELETE /api/vps/v1/virtual-machines/{virtualMachineId}/ptr/{ipAddressId}

VPS: Recovery

  • Write

    Start recovery mode

    Initiate recovery mode for a specified virtual machine. Recovery mode is a special state that allows users to perform system rescue operations, such as repairing file systems, recovering data, or troubleshooting issues that prevent the virtual machine from booting normally. Virtual machine will boot recovery disk image and original disk image will be mounted in `/mnt` directory. Use this endpoint to enable system rescue operations on VPS instances.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/recovery

  • Destructive

    Stop recovery mode

    Stop recovery mode for a specified virtual machine. If virtual machine is not in recovery mode, this operation will fail. Use this endpoint to exit system rescue mode and return VPS to normal operation.

    DELETE /api/vps/v1/virtual-machines/{virtualMachineId}/recovery

VPS: Snapshots

  • Read

    Get snapshot

    Retrieve snapshot for a specified virtual machine. Use this endpoint to view current VPS snapshot information.

    GET /api/vps/v1/virtual-machines/{virtualMachineId}/snapshot

  • Write

    Create snapshot

    Create a snapshot of a specified virtual machine. A snapshot captures the state and data of the virtual machine at a specific point in time, allowing users to restore the virtual machine to that state if needed. This operation is useful for backup purposes, system recovery, and testing changes without affecting the current state of the virtual machine. **Creating new snapshot will overwrite the existing snapshot!** Use this endpoint to capture VPS state for backup and recovery purposes.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/snapshot

  • Write

    Restore snapshot

    Restore a specified virtual machine to a previous state using a snapshot. Restoring from a snapshot allows users to revert the virtual machine to that state, which is useful for system recovery, undoing changes, or testing. Use this endpoint to revert VPS instances to previous saved states.

    POST /api/vps/v1/virtual-machines/{virtualMachineId}/snapshot/restore

  • Destructive

    Delete snapshot

    Delete a snapshot of a specified virtual machine. Use this endpoint to remove VPS snapshots.

    DELETE /api/vps/v1/virtual-machines/{virtualMachineId}/snapshot

WordPress: AI Content

  • Read

    Get generation result

    Get the result of an AI content generation started for the specified WordPress installation, such as an image generation started with POST /api/hosting/v1/accounts/{username}/wordpress/{software}/content/images/generate. While the generation is still running only `status: in-progress` is returned; poll every few seconds. Once `completed`, `result` holds the generated content shaped according to `type`: temporary image URLs together with the time they expire for `image-generation`, or the generated website document for `website-generation` (started from the Hostinger WordPress plugin). A `failed` generation has no `result`. Unknown or expired generation IDs return 404. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/content/generations/{generation_id}

  • Write

    Generate images

    Start generating one or more images from a prompt and an image type for the specified WordPress installation. The generation runs asynchronously: the response is returned right away with `status: in-progress` and a `generation_id`. Poll GET /api/hosting/v1/accounts/{username}/wordpress/{software}/content/generations/{generation_id} every few seconds until `status` is `completed` or `failed`. A completed generation returns temporary image URLs together with the time they expire; download the images before then. Images match the requested aspect ratio and are never smaller than the requested size; logos are transparent images cropped to the mark. Only one image generation can run per installation at a time: while one is still in progress the endpoint returns 409 without the ID of the running generation, so a caller that did not receive the `202` has to wait for it to finish (up to a few minutes) before starting a new one. The endpoint is limited to 10 requests per minute. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/content/images/generate

WordPress: AI Tools

  • Read

    Show AI option status

    Show the current AI option status for the Hostinger Tools plugin on the specified WordPress installation. Filter by `option` to return a single option, or omit it to return all options. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/hostinger-plugins/ai-option/status

  • Destructive

    Set AI option status

    Enable or disable an AI option for the Hostinger Tools plugin on the specified WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    PATCH /api/hosting/v1/accounts/{username}/wordpress/{software}/hostinger-plugins/ai-option/status

WordPress: Installations

  • Read

    Check if WordPress installations are valid

    Check whether one or more WordPress installations are valid and working correctly. Detects broken installations caused by missing files, broken plugins, themes and similar issues. Provide the WordPress installation (software) identifiers in the body. They can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    POST /api/hosting/v1/accounts/{username}/wordpress/installations/check-is-valid

  • Read

    List WordPress installations

    List WordPress installations on shared and cloud web hosting accounts (the `/api/hosting/v1` family, identified by `username`) accessible to the authenticated client. Agency Plan websites are not included. To work with WordPress on an Agency Plan website, list them with GET /api/agency-hosting/v1/websites?website_types=wordpress and read their details with GET /api/agency-hosting/v1/websites/{website_uid}/wordpress/settings. An account that only has Agency Plan websites receives an empty list from this endpoint. Use this endpoint to discover existing WordPress installations and to poll for installation status after calling the install endpoint. When a newly requested installation appears in this list, WordPress is ready. Filter by username and domain to narrow results to a specific website. Each installation includes a `valid` flag and, when invalid, a `validationError` describing why.

    GET /api/hosting/v1/wordpress/installations

  • Read

    List available WordPress core updates

    List available WordPress core updates for the specified installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/updates

  • Read

    Get installation JWT token

    Return a JWT token used to authenticate requests against the specified WordPress installation, including its MCP (Model Context Protocol) endpoint. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/jwt-token

  • Read

    Show WordPress core version

    Show the WordPress core version for the specified installation, along with known vulnerabilities affecting it. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/version

  • Write

    Detect WordPress installations

    Trigger a background scan to detect WordPress installations for the account. This operation is asynchronous: a successful response only means the scan has been queued. Poll GET /api/hosting/v1/wordpress/installations to fetch the detected installations once the scan completes.

    POST /api/hosting/v1/accounts/{username}/wordpress/installations/detect

  • Write

    Update WordPress core

    Update the WordPress core for the specified installation (minor update or a specific version). Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). This operation is asynchronous: a successful response only means the update job has been queued.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/update

  • Destructive

    Delete WordPress installation

    Delete the specified WordPress installation, with optional file and database removal. This removes all associated components including plugins, themes, staging websites and any other related data. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    DELETE /api/hosting/v1/accounts/{username}/wordpress/{software}

  • Destructive

    Import WordPress website

    Import WordPress website to the specified domain. WARNING: this overwrites the website's existing contents and cannot be undone — verify this is intended before calling this endpoint. This endpoint allows you to import a WordPress website from archive and database files that have been uploaded to the website's directory.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/wordpress/import

  • Destructive

    Install WordPress

    Install WordPress on an existing website. The website must already exist before calling this endpoint. To create a new website first, use POST /api/hosting/v1/orders/{order_id}/onboardings (`hosting_websites_start-setup`) and poll GET /api/hosting/v1/onboardings (`hosting_websites_list-setups`) with the `domain` filter until its `status` is `completed`. Send `type: headless` to turn a headless website (for example one created by `hosting_websites_start-setup` with `type: headless_empty`) into a headless WordPress website: WordPress is installed into the `cms` directory with the Hostinger headless MU plugin and the website is marked as a headless WordPress website. `directory` is not allowed with it. The target website must already be headless: the headless install rewrites the root `.htaccess`, so on any other website the request is rejected with 422. Call GET /api/hosting/v1/wordpress/installations (`wordpress_installations_list`) filtered by username and domain before proceeding to check whether WordPress is already installed on the target domain/path. If WordPress already exists and `overwrite` is false (the default), the async job will fail. This operation is asynchronous: a successful response only means the install job has been queued, not that WordPress is ready. Installation typically takes 1-2 minutes. Poll GET /api/hosting/v1/wordpress/installations (`wordpress_installations_list`) filtered by username and domain to track progress. When the installation appears in that list, WordPress is ready. Returns 422 when the account already uses all the databases its plan allows, unless `database.name` is an existing database on the account.

    POST /api/hosting/v1/accounts/{username}/wordpress/installations

WordPress: LiteSpeed Cache

  • Read

    Show LiteSpeed Cache status

    Show the LiteSpeed Cache status for the specified WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/litespeed-cache/status

  • Destructive

    Purge LiteSpeed Cache

    Purge the LiteSpeed Cache for the specified WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/litespeed-cache/purge

WordPress: Login

  • Write

    Create login links

    Create temporary auto-login links for the specified WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/login/links

WordPress: Maintenance

  • Read

    Show maintenance status

    Show the maintenance mode status for the specified WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/maintenance/status

  • Destructive

    Toggle maintenance mode

    Enable or disable maintenance mode for the specified WordPress installation, based on the `enabled` flag. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    PATCH /api/hosting/v1/accounts/{username}/wordpress/{software}/maintenance/toggle

WordPress: Object Cache

  • Read

    Show Memcached object cache status

    Show the Memcached object cache status for the specified WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/memcached/status

  • Write

    Toggle Memcached object cache

    Activate or deactivate the Memcached object cache for the specified WordPress installation, based on the `enabled` flag. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    PATCH /api/hosting/v1/accounts/{username}/wordpress/{software}/memcached/toggle

WordPress: Plugins

  • Read

    List available WordPress plugins

    List plugins recommended for installation on a WordPress installation that are not yet installed. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/available

  • Read

    List installed WordPress plugins

    List plugins installed on a WordPress installation, including their status, available updates and known vulnerabilities. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins

  • Read

    Search WordPress plugins

    Search the WordPress.org plugin directory for plugins available to install. Use the returned `slug` values with POST /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/install.

    GET /api/hosting/v1/wordpress/plugins

  • Read

    List suggested WordPress plugins

    List curated plugin suggestions grouped by website type. Use the returned `slug` values with POST /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/install.

    GET /api/hosting/v1/wordpress/plugins/suggested

  • Read

    Check if WooCommerce is installed

    Check whether WooCommerce is installed on any WordPress installation of a domain. Optionally filter by domain to scope the check.

    GET /api/hosting/v1/wordpress/plugins/is-woocommerce-installed

  • Write

    Activate WordPress plugin

    Activate an installed plugin on a WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). This operation is asynchronous: a successful response only means the activation job has been queued.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/activate

  • Write

    Deactivate WordPress plugin

    Deactivate an installed plugin on a WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). This operation is asynchronous: a successful response only means the deactivation job has been queued.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/deactivate

  • Write

    Deploy WordPress plugin

    Deploy a WordPress plugin from an already uploaded directory. This endpoint allows you to deploy a WordPress plugin that has been uploaded to the website's directory. The plugin will be activated and made available in the WordPress admin panel.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/wordpress/plugins/deploy

  • Write

    Install WordPress plugins

    Install one or more plugins on an existing WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). Use GET /api/hosting/v1/wordpress/plugins to discover the plugin slugs available for installation. This operation is asynchronous: a successful response only means the install job has been queued, not that the plugins are ready.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/install

  • Write

    Uninstall WordPress plugins

    Uninstall one or more plugins from a WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). This operation is asynchronous: a successful response only means the uninstall job has been queued.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/uninstall

  • Write

    Update Hostinger WordPress plugin

    Update a Hostinger plugin to its latest version on a WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). This operation is asynchronous: a successful response only means the update job has been queued.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/hostinger/update

  • Write

    Update WordPress plugins

    Update one or more installed plugins to their latest version on a WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). This operation is asynchronous: a successful response only means the update job has been queued.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/plugins/update

WordPress: Themes

  • Read

    List installed WordPress themes

    List themes installed on a WordPress installation, including their status, available updates and known vulnerabilities. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).

    GET /api/hosting/v1/accounts/{username}/wordpress/{software}/themes

  • Read

    List WordPress themes

    List WordPress themes available to install. Use the returned `slug` values with POST /api/hosting/v1/accounts/{username}/wordpress/{software}/themes/install.

    GET /api/hosting/v1/wordpress/themes

  • Write

    Activate WordPress theme

    Activate an installed theme on a WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). This operation is asynchronous: a successful response only means the activation job has been queued.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/themes/activate

  • Write

    Deploy WordPress theme

    Deploy a WordPress theme from an already uploaded directory. This endpoint allows you to deploy a WordPress theme that has been uploaded to the website's directory. The theme can be optionally activated after deployment.

    POST /api/hosting/v1/accounts/{username}/websites/{domain}/wordpress/themes/deploy

  • Write

    Install WordPress theme

    Install a theme on an existing WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). When the theme is one of the Hostinger themes (hostinger-blog, hostinger-affiliate-theme, hostinger-ai-theme), the optional `palette`, `layout`, and `font` fields are forwarded to the custom installer (defaults: palette1, layout1, default). For any other theme they are ignored. This operation is asynchronous: a successful response only means the install job has been queued, not that the theme is ready.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/themes/install

  • Write

    Uninstall WordPress themes

    Uninstall one or more themes from a WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). This operation is asynchronous: a successful response only means the uninstall job has been queued.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/themes/uninstall

  • Write

    Update WordPress themes

    Update one or more installed themes to their latest version on a WordPress installation. Provide the WordPress installation (software) identifier in the path. It can be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field). This operation is asynchronous: a successful response only means the update job has been queued.

    POST /api/hosting/v1/accounts/{username}/wordpress/{software}/themes/update

See How connections work for access and permissions, or browse all integrations.