# Create a new andon call (/docs/api-reference/andon/AndonController_create)

`POST /api/factories/{factoryId}/andon-calls`

Base URL: https://api.xentr.ai

Authentication: bearer token (`Authorization: Bearer <token>`).

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `factoryId` | path | yes | string | Factory ID |

## Request body

Required.

Content type: `application/json`

```json
{
  "type": "object",
  "properties": {
    "machineId": {
      "type": "string",
      "description": "Machine ID this call is for",
      "example": "CNC-001"
    },
    "callType": {
      "type": "string",
      "description": "Type of andon call",
      "enum": [
        "quality",
        "material",
        "maintenance",
        "safety"
      ],
      "example": "maintenance"
    },
    "openedBy": {
      "type": "string",
      "description": "User id of the operator who opened the call.",
      "example": "a1b2c3d4-1111-2222-3333-444455556666"
    },
    "notes": {
      "type": "string",
      "description": "Free-text notes describing the issue.",
      "example": "Coolant level low, need refill before next cycle."
    }
  },
  "required": [
    "machineId",
    "callType"
  ]
}
```

## Responses

### 201: Andon call created