> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# channel.updated

> Fired when a sales channel is created or updated in Fire.

Fire emits this event when a channel's configuration changes — name, status, authentication type, or base URL. Your system should update its local channel mapping and re-fetch the channel list if it caches it.

## Payload

```json theme={null}
{
  "event": {
    "id": "evt_abc200",
    "type": "channel.updated",
    "createdAt": "2025-01-20T15:30:00Z",
    "timezone": "America/Guayaquil"
  },
  "data": {
    "account": "1",
    "country": "6",
    "vendorId": 16,
    "channel": {
      "channelId": "CH-IFOOD-001",
      "code": "IFOOD",
      "name": "iFood",
      "description": "Orders received via iFood marketplace",
      "active": "ACTIVE",
      "authType": "API_KEY",
      "baseUrl": "https://api.ifood.com.br",
      "services": [
        {
          "code": "DELIVERY",
          "serviceId": "3",
          "referenceName": "Domicilios iFood"
        },
        {
          "code": "TAKEAWAY",
          "serviceId": "1",
          "referenceName": "Retiro en tienda"
        }
      ],
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-01-20T15:30:00.000Z"
    }
  }
}
```

## Fields

### `data`

| Field      | Type    | Description                                         |
| ---------- | ------- | --------------------------------------------------- |
| `account`  | string  | Account identifier — required by downstream systems |
| `country`  | string  | Country identifier — required by downstream systems |
| `vendorId` | integer | Brand identifier                                    |
| `channel`  | object  | Updated channel object — see below                  |

### `data.channel`

| Field         | Type           | Description                                                                           |
| ------------- | -------------- | ------------------------------------------------------------------------------------- |
| `channelId`   | string         | Unique channel identifier                                                             |
| `code`        | string         | Short code for the channel (e.g. `IFOOD`, `RAPPI`, `KIOSK`)                           |
| `name`        | string         | Display name                                                                          |
| `description` | string \| null | Optional description                                                                  |
| `active`      | string         | Channel status: `ACTIVE` or `INACTIVE`                                                |
| `authType`    | string         | Authentication mechanism: `API_KEY`, `OAUTH2`, `BASIC_AUTH`, `XMART_LOGIN`, or `NONE` |
| `baseUrl`     | string \| null | Base URL for the channel's integration endpoint                                       |
| `services`    | object\[]      | Services available through this channel                                               |
| `createdAt`   | string         | ISO 8601 creation timestamp                                                           |
| `updatedAt`   | string         | ISO 8601 last-updated timestamp                                                       |

### `data.channel.services[n]`

| Field           | Type   | Description                                     |
| --------------- | ------ | ----------------------------------------------- |
| `code`          | string | Service type code (e.g. `DELIVERY`, `TAKEAWAY`) |
| `serviceId`     | string | Unique service identifier                       |
| `referenceName` | string | Human-readable service name for this channel    |

## Usage

<Steps>
  <Step title="Verify the signature">
    Validate `X-Fire-Signature`. See [Authentication](/en/authentication).
  </Step>

  <Step title="Acknowledge immediately">
    Return `200 OK` before processing.
  </Step>

  <Step title="Update your channel mapping">
    Upsert the channel in your local store using `channelId` as the key. If the channel transitions to `INACTIVE`, stop routing events or orders to it.
  </Step>
</Steps>