Install WordPress theme

Install a theme on an existing WordPress installation.

Install WordPress theme

post

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.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

usernamestringRequiredExample: u123456789

softwarestringRequired

WordPress installation (software) identifier

Example: 1232456789Pattern: ^[0-9]+$

Body

themestring · min: 1 · max: 50Required

Slug of the theme to install. Hostinger theme slugs (hostinger-blog, hostinger-affiliate-theme, hostinger-ai-theme) trigger the custom installer and forward the optional palette/layout/font fields; any other WordPress theme slug uses the standard installer and ignores those fields.

Example: hostinger-blog

palettestring · min: 1 · max: 50 · nullableOptional

Palette identifier. Only applied when the theme is a Hostinger theme; the default is used when omitted.

Default: palette1Example: palette1

layoutstring · min: 1 · max: 50 · nullableOptional

Layout identifier. Only applied when the theme is a Hostinger theme; the default is used when omitted.

Default: layout1Example: layout1

fontstring · enum · nullableOptional

Font identifier. Only applied when the theme is a Hostinger theme; the default is used when omitted.

Default: defaultExample: defaultPossible values:

Responses

200

Success empty response

application/json

messagestringOptionalExample: Request accepted

401

Unauthenticated response

application/json

422

Validation error response

application/json

500

Error response

application/json

post/api/hosting/v1/accounts/{username}/wordpress/{software}/themes/install

POST /api/hosting/v1/accounts/{username}/wordpress/{software}/themes/install HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 83

{
  "theme": "hostinger-blog",
  "palette": "palette1",
  "layout": "layout1",
  "font": "default"
}

{
  "message": "Request accepted"
}