Call enquiry example

Prev Next

An example call.create request for a phone enquiry (category 62, Care Enquiry via Phone). All names, contact details and messages are made up.

Who can use it: enquiry webhooks are available to Enhanced and Platinum subscribers. See Enquiry Webhooks Overview.

The fields outside categorySpecificData are the same for every type and are described in Enquiry Webhook Request. Every field listed below is always sent; if the information was not collected, its value is null.

Fields

Sent as call.create when a phone call to a setting's carehome.co.uk phone number is recorded as a care enquiry (category 62). data.id is the ID of the call record, not an enquiry ID. entrydate is when the call started, emailto and the address fields are always null, and bodycontent is an HTML summary of the call.

FieldTypeDescription
commentstring or nullThe caller's comments.
summarystring or nullA summary of the call.
enquirerTypestring or nullWho the caller is. One of the listed values below.
agentNamestring or nullThe name of the person at the setting who took the call.
whoIsNeedOfCarestring or nullWho needs care, from the enquirer's point of view. One of the listed values below.
careNeededTypestring or nullThe type of care needed. One of the listed values below.
howSoonTypestring or nullHow soon care is needed. One of the listed values below.
stayLengthTypestring or nullWhether the stay is long-term or short-term. One of the listed values below.
fundingTypestring or nullHow the care will be paid for. One of the listed values below.
enquirerInterestedInATourstringYes if the caller said they would like a tour, otherwise No.
agentOfferedATourstringYes if the person who took the call offered a tour, otherwise No.
enquirerLeftVoicemailboolean or nulltrue if the caller left a voicemail.
personNeedingCareFurtherRequirementsstring or nullFurther details about the care needed.
personNeedingCareNamestring or nullThe full name of the person who needs care, if both a first name and a surname were given.
howDidAgentHandleCallstring or nullFeedback on how the call was handled.

Example request

{
  "type": "call.create",
  "timestamp": "2026-11-03T10:26:10.344Z",
  "data": {
    "id": 98765,
    "category": {
      "id": 62,
      "name": "Care Enquiry via Phone"
    },
    "member": {
      "id": "123456",
      "name": "Example Care Home",
      "postcode": "AB1 2CD"
    },
    "group": {
      "id": "654321",
      "name": "Example Care Group",
      "postcode": "AB1 2CD"
    },
    "emailto": null,
    "emailfrom": "example@example.com",
    "entrydate": "2026-11-03T10:15:00.000Z",
    "bodycontent": "<p><strong>Lead Summary</strong><br>Example summary text.</p><p><strong>Additional Details about Care Requirements</strong><br>N/A</p><p><strong>Enquirer Interested in a Tour</strong><br>Yes</p><p><strong>Agent Offered a Tour</strong><br>Yes</p><p><strong>Enquirer Comment</strong><br>Example message text.</p>",
    "firstname": "Example",
    "surname": "Name",
    "address1": null,
    "address2": null,
    "address3": null,
    "town": null,
    "postcode": null,
    "telephone": "01234 567890",
    "isAnonymised": "No",
    "categorySpecificData": {
      "comment": "Example message text.",
      "summary": "Example summary text.",
      "enquirerType": "Individual",
      "agentName": "Example Name",
      "whoIsNeedOfCare": "A parent",
      "careNeededType": "Older person residential",
      "howSoonType": "1 - 3 months",
      "stayLengthType": "Permanent/Long-term",
      "fundingType": "Self funding (Private)",
      "enquirerInterestedInATour": "Yes",
      "agentOfferedATour": "Yes",
      "enquirerLeftVoicemail": false,
      "personNeedingCareFurtherRequirements": null,
      "personNeedingCareName": "Example Name",
      "howDidAgentHandleCall": "Example feedback text."
    }
  }
}

Listed values

These fields contain one of the values below, or null. N/A can also appear, mainly on call enquiries. We may add values in future, so make sure your system accepts values it does not recognise.

whoIsNeedOfCare

  • Myself
  • A parent
  • A partner
  • Another family member
  • A friend
  • A client

careNeededType

  • Older person residential
  • Older person residential dementia
  • Older person nursing
  • Older person nursing dementia
  • Other types of care
  • Not sure

howSoonType

  • Immediately (1 day - 1 week)
  • 1 week - 1 month
  • 1 - 3 months
  • 3 - 6 months
  • 6 months +

stayLengthType

  • Permanent/Long-term
  • Respite/Short-term

fundingType

  • Self funding (Private)
  • Local Authority with Top-up
  • Local Authority
  • NHS Continuing Healthcare (CHC)
  • Not sure

enquirerType (call enquiries only)

  • Individual
  • Social Services
  • Hospital Discharge
  • Agency
  • Unknown