# Hostinger

Web hosting and domain management platform with APIs for billing, domains, DNS, and VPS management

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 24
- **Triggers:** 0
- **Slug:** `HOSTINGER`
- **Version:** 00000000_00

## Tools

### Check Domain Availability

**Slug:** `HOSTINGER_CHECK_DOMAIN_AVAILABILITY`

Check domain availability. Verify if domain names are available for registration across multiple TLDs. Use this endpoint to check domain availability before purchase. Multiple TLDs can be checked at once. TLDs should be provided without leading dot (e.g., 'com', 'net', 'org'). If you want alternative domain suggestions with the response, provide only one TLD and set with_alternatives to true. Note: This endpoint has a rate limit of 10 requests per minute.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tlds` | array | Yes | List of TLDs to check availability for (without leading dot, e.g. 'com', 'net', 'org') |
| `domain` | string | Yes | Domain name to check availability (without TLD) |
| `with_alternatives` | boolean | No | Should response include alternative domain suggestions. When set to true, provide only one TLD |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create VPS Public Key

**Slug:** `HOSTINGER_CREATE_PUBLIC_KEY`

Create public key. Add a new public key to your account for VPS SSH authentication. Use this endpoint to register SSH keys that can be used for authenticating to VPS instances. The public key will be associated with your account and can be assigned to VPS during creation or via VPS management endpoints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | SSH public key content (e.g., ssh-rsa AAAA... user@host). |
| `name` | string | Yes | Name identifier for the public key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create WHOIS Profile

**Slug:** `HOSTINGER_CREATE_WHOIS_PROFILE`

Create a WHOIS contact profile for domain registration. Use this endpoint to add new contact information that can be used when registering domains. The WHOIS profile is required for domain registration and contains contact details such as name, email, phone, and address. The entity_type determines whether the contact is an individual or an organization. The created profile can be applied to domains matching the specified TLD.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tld` | string | Yes | TLD of the domain (without leading dot) |
| `country` | string | Yes | ISO 3166 2-letter country code |
| `entity_type` | string ("individual" | "organization") | Yes | Legal entity type |
| `whois_details` | object | Yes | WHOIS contact details |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Public Key

**Slug:** `HOSTINGER_DELETE_PUBLIC_KEY`

Delete public key. Use this endpoint to remove unused SSH public keys from your account. Note: Deleting a public key from your account does not remove it from any virtual machines.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `public_key_id` | integer | Yes | The unique identifier of the public key to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Free Subdomain

**Slug:** `HOSTINGER_GENERATE_FREE_SUBDOMAIN`

Generate a free subdomain. Create 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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get DNS Records

**Slug:** `HOSTINGER_GET_DNS_RECORDS`

Tool to retrieve DNS records for a domain. Use this endpoint to view current DNS configuration for domain management purposes. Example use cases: - Review current DNS settings before making changes - Check propagation status after DNS updates - Audit DNS configuration for a domain

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | The domain name for which to retrieve DNS records |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Domain Forwarding

**Slug:** `HOSTINGER_GET_DOMAIN_FORWARDING`

Tool to retrieve domain forwarding configuration. Use when you need to view the current redirect settings for a domain, including the target URL and redirect type (301/302).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Domain name to get forwarding configuration for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get VPS Template Details

**Slug:** `HOSTINGER_GET_TEMPLATE_DETAILS`

Get template details. Retrieve detailed information about a specific OS template for virtual machines. Use this endpoint to view specific template specifications before deployment. Example use cases: - Review template details before VPS deployment - Check OS version and documentation links - Verify template availability and specifications

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | integer | Yes | Template ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get WHOIS Profile

**Slug:** `HOSTINGER_GET_WHOIS_PROFILE`

Get WHOIS profile. Retrieve a WHOIS contact profile for domain registration contact information. Use this endpoint to view domain registration contact information including registrant, admin, and technical contacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `whois_id` | integer | Yes | The unique identifier of the WHOIS contact profile to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get WHOIS Profile Usage

**Slug:** `HOSTINGER_GET_WHOIS_PROFILE_USAGE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `whois_id` | integer | Yes | The unique identifier of the WHOIS contact profile |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Catalog Items

**Slug:** `HOSTINGER_LIST_CATALOG_ITEMS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Filter catalog items by name. Use `*` for wildcard search, e.g. `.COM*` to find .com domains |
| `category` | string ("DOMAIN" | "VPS") | No | Category for filtering catalog items. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List VPS Data Centers

**Slug:** `HOSTINGER_LIST_DATA_CENTERS`

Get data center list. Retrieve all available data centers. Use this endpoint to view location options before deploying VPS instances. Returns a list of all available data centers with their city, continent, country code, and name information.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List DNS Snapshots

**Slug:** `HOSTINGER_LIST_DNS_SNAPSHOTS`

Tool to retrieve DNS snapshots for a domain. Use when you need to view available DNS backup points for restoration or audit purposes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | The domain name for which to retrieve DNS snapshots |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Domains

**Slug:** `HOSTINGER_LIST_DOMAINS`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Hosting Orders

**Slug:** `HOSTINGER_LIST_ORDERS`

Tool to list hosting orders. Retrieve a paginated list of orders accessible to the authenticated client. 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve. |
| `per_page` | integer | No | Number of items to return per page. Default is 25. |
| `statuses` | array | No | Filter orders by their statuses (e.g., 'active', 'suspended'). |
| `order_ids` | array | No | Filter by specific order IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Payment Methods

**Slug:** `HOSTINGER_LIST_PAYMENT_METHODS`

Get payment method list. Retrieve available payment methods that can be used for placing new orders. Use this endpoint to view available payment options before creating orders. This action requires no request parameters. Note: To add a new payment method, use hPanel instead: https://hpanel.hostinger.com/billing/payment-methods

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Public Keys

**Slug:** `HOSTINGER_LIST_PUBLIC_KEYS`

Get public keys. Retrieve public keys associated with your account. Use this endpoint to view available SSH keys for VPS authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Subscriptions

**Slug:** `HOSTINGER_LIST_SUBSCRIPTIONS`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List VPS Templates

**Slug:** `HOSTINGER_LIST_TEMPLATES`

Get templates. Retrieve available OS templates for virtual machines. Use this endpoint to view operating system options before creating or recreating VPS instances. Returns a list of all available templates with their ID, name, description, and documentation links.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Virtual Machines

**Slug:** `HOSTINGER_LIST_VIRTUAL_MACHINES`

Get virtual machines. Retrieve all available virtual machines. Use this endpoint to view available VPS instances. Returns a list of all virtual machines with their configuration details including CPU, memory, disk, IP addresses, and current state.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Websites

**Slug:** `HOSTINGER_LIST_WEBSITES`

List websites. Retrieve a paginated list of websites (main and addon types) 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. Use the available query parameters to filter results by username, order ID, enabled status, or domain name for more targeted results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `domain` | string | No | Filter by domain name (exact match) |
| `order_id` | integer | No | Filter by order ID |
| `per_page` | integer | No | Number of items per page (1-100). If not specified, the server's default will be used |
| `username` | string | No | Filter by specific username |
| `is_enabled` | boolean | No | Filter by enabled status |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List WHOIS Profiles

**Slug:** `HOSTINGER_LIST_WHOIS_PROFILES`

Retrieve WHOIS contact profiles for domain registration. Use this endpoint to view available contact profiles that can be used when registering domains. Optionally filter by TLD to get profiles applicable to specific domain extensions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tld` | string | No | Filter by TLD (without leading dot) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate DNS Records

**Slug:** `HOSTINGER_VALIDATE_DNS_RECORDS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zone` | array | Yes | Array of DNS zone entries to validate. |
| `domain` | string | Yes | The domain name to validate DNS records for. |
| `overwrite` | boolean | No | If true, resource records (RRs) matching name and type will be deleted and new RRs created. Otherwise, ttl's are updated and new records appended. If no matching RRs found, they are created. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Domain Ownership

**Slug:** `HOSTINGER_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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Domain name to verify ownership for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
