Create firewall rule

Create new firewall rule for a specified firewall.

Create firewall rule

post

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.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

firewallIdintegerRequired

Firewall ID

Example: 9449049

Body

protocolstring · enumRequiredExample: TCPPossible values:

portstringRequired

Port or port range, ex: 1024:2048

Example: 443

sourcestring · enumRequiredExample: anyPossible values:

source_detailstringRequired

IP range, CIDR, single IP or any

Example: 351.15.24.0/24

Responses

200

Success response

application/json

idintegerOptional

Firewall rule ID

Example: 24541

actionstring · enumOptional

Firewall rule action

Example: acceptPossible values:

protocolstring · enumOptional

Firewall rule protocol

Example: TCPPossible values:

portstringOptional

Firewall rule destination port: single or port range

Example: 1024:2048

sourcestringOptional

Firewall rule source. Can be any or custom

Example: any

source_detailstringOptional

Firewall rule source detail. Can be any or IP address, CIDR or range

Example: any

401

Unauthenticated response

application/json

422

Validation error response

application/json

500

Error response

application/json

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

POST /api/vps/v1/firewall/{firewallId}/rules HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 79

{
  "protocol": "TCP",
  "port": "443",
  "source": "any",
  "source_detail": "351.15.24.0/24"
}

{
  "id": 24541,
  "action": "accept",
  "protocol": "TCP",
  "port": "1024:2048",
  "source": "any",
  "source_detail": "any"
}