Create a firewall entry
Adds an address or a range at one level: a company, a website, one environment, or yourself. A range may be as wide as /24 (IPv6 /48); ask for a wider one with a range request. The address works once the change has been applied.
Body
An IPv4 or IPv6 address, or a range in CIDR form. A range may be as wide as /24 (IPv6 /48). Private, reserved and provider ranges are refused. Up to 64 characters.
A note to recognise the address by. Up to 200 characters.
After how many days the address stops being allowed. Null, or left out, for no expiry.
13090365nullThe id of the environment, website or company. For user, your own user id. At least 1.
The level an address is held at. user is yourself.
environmentwebsitecompanyuserLeft out, the address gets both. What the address may reach. ssh is SSH only, web the website only, both both.
bothsshwebFields
Returns
201 The address was added. Follow change_id with GET /firewall/changes/{change} to see it applied.
Fields of the 201 answer
The change to follow with GET /firewall/changes/{change}. Null when nothing needs applying.
Set when an entry at another level already allows the address: the level that does.
agencycompanywebsiteenvironmentuserpresethttp_auth_rulenullOne address or range on a firewall list.
Fields
Who added an address or made a change.
Fields
Null when the person has been removed, or when Corefinity support added the address.
The person Corefinity support added it for.
True when Corefinity support added the address for a customer.
Where a carried address came from.
When the entry last changed where it applies. Compare it with a target's applied_at to tell whether the change is live there. Format: date-time.
The address in CIDR form. A single address reads /32 (IPv6 /128). Removing the entry asks you to send this back.
Format: date-time.
Corefinity's reason, once a range request is rejected.
Whether you may change or remove the entry.
When the address stops being allowed. Null for no expiry. Format: date-time.
The IP version.
46The entry id the /firewall/entries/{entry} endpoints take.
The level the address comes from, as you see it. agency is an address of your agency.
agencycompanywebsiteenvironmentuserpresethttp_auth_ruleWhere an address is held: a company, a website, an environment or a person. http_auth_rule is an address carried over with a password-protected path.
Fields
At least 1.
companywebsiteenvironmentuserhttp_auth_ruleThe protected path of a carried http_auth_rule address.
The reason given with a range request.
What an address may reach.
Fields
The address may connect over SSH.
The address sees the website without the HTTP authentication login or the maintenance page.
How the entry came to be, such as manual, one_click (the address you were calling from) or an import.
manualone_clickon_behalfip_whitelistlegacy_importlegacy_usagegcp_rule_importlegacy_deltaplatform_seedhttp_auth_carrypending_approval is a range request waiting for Corefinity. removing lasts until the address is gone everywhere.
activepending_approvalrejectedremovingexpiredTrue while the address's website access is paused by the platform.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | firewall_not_editable | You can see this entry but you cannot change it. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
404 | not_found | Not found. |
422 | firewall_address_invalid | Enter an IPv4 or IPv6 address, or a range in CIDR form (for example 203.0.113.0/24). |
422 | firewall_address_refused | That address is in a private range and cannot be allowed. |
422 | firewall_approval_required | Ranges wider than /24 (IPv6 /48) need approval from Corefinity. Send it as a range request. |
422 | firewall_cap_exceeded | This list already holds its limit of 200 addresses. |
422 | firewall_duplicate | That address is already on this list. |
422 | firewall_width_refused | That range is far too wide to allow. Ranges of /8 or wider are never accepted. |
422 | invalid_arguments | The arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again. |
429 | firewall_throttled | Too many firewall changes. Wait a minute and try again. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/firewall/entries \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"address": "198.51.100.0/24",
"comment": "Head office",
"owner_id": 1204,
"owner_type": "company",
"scope": "ssh"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/firewall/entries', [
'address' => '198.51.100.0/24',
'comment' => 'Head office',
'owner_id' => 1204,
'owner_type' => 'company',
'scope' => 'ssh',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/firewall/entries', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
address: '198.51.100.0/24',
comment: 'Head office',
owner_id: 1204,
owner_type: 'company',
scope: 'ssh',
}),
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.post(
"https://manage.corefinity.com/api/firewall/entries",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"address": "198.51.100.0/24",
"comment": "Head office",
"owner_id": 1204,
"owner_type": "company",
"scope": "ssh",
},
)
data = res.json() if res.content else None{
"change_id": 5310,
"covered_by": null,
"entry": {
"added_by": {
"name": "Eleanor Finch",
"on_behalf_of": null,
"support": false
},
"carried_from": null,
"changed_at": "2026-11-06T09:16:40Z",
"cidr": "203.0.113.42/32",
"comment": "Contractor",
"created_at": "2026-11-06T09:16:40Z",
"decision_reason": null,
"editable": true,
"expires_at": "2027-01-04T09:16:40Z",
"family": 4,
"id": 9002,
"layer": "environment",
"owner": {
"id": 1311,
"name": "Production",
"type": "environment"
},
"path": null,
"request_reason": null,
"scope": {
"ssh": true,
"web": true
},
"source": "manual",
"status": "active",
"web_paused": false
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "firewall_address_invalid",
"field": "address",
"message": "Enter an IPv4 or IPv6 address, or a range in CIDR form (for example 203.0.113.0/24).",
"reason": "firewall_address_invalid"
}{
"code": "firewall_throttled",
"field": null,
"message": "Too many firewall changes. Wait a minute and try again.",
"reason": "firewall_throttled"
}Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.