CorefinityCorefinityDocs
Open the Control PanelControl Panel
Agency · 4 of 7

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.

POST/api/agency/page/change-request

Body

addressstring

Up to 255 characters.

contentstring

Up to 65,535 characters.

email_addressstring

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.

listing_descriptionstring

Up to 65,535 characters.

namestring

Up to 255 characters.

phone_numberstring

A UK phone number, such as 01632 960 123. Up to 255 characters.

servicesarray of strings

The services your agency offers, as names. It replaces the whole list. Up to 30 items.

slugstring or null

Lower-case letters, digits and hyphens. Not accepted on a first request. Up to 255 characters.

subheadingstring

Up to 255 characters.

website_urlstring

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
dataobjectRequired
Fields
change_requestobject or any or nullRequired

The request that is waiting for approval.

pageobject or any or nullRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403forbiddenThe person is not allowed to do this.
403scope_requiredUse a token with the scope named in scope.
422invalidFix the field named in field; errors says why.
429rate_limitedWait 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"
  }'
{
  "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"
    }
  }
}
Try it

Try it is off for this endpointIt sends email to real people. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT