Create a callout event | Aura Panic API

curl -X POST https://staging-panic.aura.services/panic-api/v2/callouts/12345/events \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "source": "customer",
  "event": "Suspicious vehicle parked outside the property — please dispatch a responder."
}'

{
  "calloutEvent": {
    "id": 12345,
    "calloutId": 12345,
    "calloutEventTypeId": 1,
    "event": {
      "body": "Suspicious vehicle parked outside the property — please dispatch a responder.",
      "role": "customer",
      "supplierId": 1
    },
    "createdBy": "Dev Bid",
    "integrationUserId": 1,
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "calloutEventType": {
      "id": 1,
      "value": "COMMENT",
      "description": "comment",
      "colour": "#2196f3",
      "iconUrl": "string",
      "shouldFilterBySupplier": true,
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z"
    },
    "calloutEventTags": [
      {
        "id": 299263,
        "calloutEventId": 1,
        "calloutEventTagId": 1,
        "createdAt": "2024-01-15T09:30:00Z",
        "updatedAt": "2024-01-15T09:30:00Z",
        "tagType": {
          "tagType": {
            "id": 1,
            "value": "@admin",
            "createdAt": "2024-01-15T09:30:00Z",
            "updatedAt": "2024-01-15T09:30:00Z"
          }
        },
        "calloutEventTagType": {
          "id": 1,
          "value": "@admin",
          "createdAt": "2024-01-15T09:30:00Z",
          "updatedAt": "2024-01-15T09:30:00Z"
        }
      }
    ],
    "integrationUser": {}
  },
  "calloutEventTags": [
    {
      "id": 299263,
      "calloutEventId": 1,
      "calloutEventTagId": 1,
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z",
      "tagType": {
        "tagType": {
          "id": 1,
          "value": "@admin",
          "createdAt": "2024-01-15T09:30:00Z",
          "updatedAt": "2024-01-15T09:30:00Z"
        }
      },
      "calloutEventTagType": {
        "id": 1,
        "value": "@admin",
        "createdAt": "2024-01-15T09:30:00Z",
        "updatedAt": "2024-01-15T09:30:00Z"
      }
    }
  ]
}

Creates a chat message or event in the callout conversation with the control centre. The response includes the created calloutEvent and any derived calloutEventTags.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

calloutIdintegerRequired

Callout identifier.

Request

This endpoint expects an object.

sourcestringRequired

Who is sending the event, e.g. customer.

eventstringRequired

The message body to send to the control centre.

Response

Successful.

calloutEventobject

calloutEventTagslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error