Create a page change request
Asks Corefinity to create your agency page (send every field but slug; your role needs createAgencyPage) or to change it (send only the fields to change; your role needs editAgencyPage). The live page keeps its values until Corefinity approves the request, and a new request replaces one that is still waiting. Images are added in the Control Panel.
Body
Up to 255 characters.
Up to 65,535 characters.
An address whose domain can receive email; the domain is looked up, so the placeholder address in the example is refused 422 on this field. Up to 255 characters.
Up to 65,535 characters.
Up to 255 characters.
A UK phone number, such as 01632 960 123. Up to 255 characters.
The services your agency offers, as names. It replaces the whole list. Up to 30 items.
Lower-case letters, digits and hyphens. Not accepted on a first request. Up to 255 characters.
Up to 255 characters.
A full address, starting https:// or http://. Up to 255 characters.
Returns
200 The page as it is now, and the request that is waiting for approval. No request is raised when nothing differs from the page.
Fields of the 200 answer
Fields
The request that is waiting for approval.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | forbidden | The person is not allowed to do this. |
403 | scope_required | Use a token with the scope named in scope. |
422 | invalid | Fix the field named in field; errors says why. |
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/agency/page/change-request \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"subheading": "Magento and Shopware specialists"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/agency/page/change-request', [
'subheading' => 'Magento and Shopware specialists',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/agency/page/change-request', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
subheading: 'Magento and Shopware specialists',
}),
});
// 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/agency/page/change-request",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"subheading": "Magento and Shopware specialists",
},
)
data = res.json() if res.content else None{
"data": {
"change_request": {
"address": "14 Harbour Row, Bristol",
"content": "We build and run online shops.",
"created_at": "2026-11-09T10:15:00Z",
"email_address": "[email protected]",
"id": 3319,
"listing_description": "Magento and Shopware builds for UK retailers.",
"name": "Northwind Digital",
"page_id": 3207,
"phone_number": "01632 960 123",
"services": [
"Magento",
"Hosting"
],
"slug": "northwind-digital",
"status": "pending",
"subheading": "Magento and Shopware specialists",
"type": "edit",
"updated_at": "2026-11-09T10:15:00Z",
"website_url": "https://northwind-digital.example.com"
},
"page": {
"address": "14 Harbour Row, Bristol",
"content": "We build and run online shops.",
"email_address": "[email protected]",
"id": 3207,
"listing_description": "Magento and Shopware builds for UK retailers.",
"name": "Northwind Digital",
"phone_number": "01632 960 123",
"published": true,
"services": [
"Magento",
"Hosting"
],
"slug": "northwind-digital",
"status": "pending_change",
"subheading": "Magento specialists",
"website_url": "https://northwind-digital.example.com"
}
}
}{
"message": "Unauthenticated."
}{
"code": "forbidden",
"message": "You are not allowed to request an agency page.",
"reason": "forbidden",
"status": "error"
}{
"code": "invalid",
"errors": {
"name": [
"Give at least one field of the page to change."
]
},
"field": "name",
"message": "Give at least one field of the page to change.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it is off for this endpointIt sends email to real people. Copy the request and run it yourself when you are sure.