# SimReplaced

Fired when a SIM replacement has been completed and a new eSIM profile is provisioned.

> Enterprise API · https://developer.telgea.com/docs/enterprise/webhooks/sim-replaced

## SimReplaced [#simreplaced]

Fired when a SIM replacement is complete. The old SIM is deactivated and a new eSIM profile is provisioned. The payload carries the new SIM's activation code and PIN and PUK codes.

## Payload [#payload]

```json event=SimReplaced
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "eventType": "SimReplaced",
  "timestamp": "2026-03-25T14:35:00.000Z",
  "organizationId": "b5e2d7f3-a1c4-4e89-9f6b-3d8a7c5e1024",
  "data": {
    "userId": "d4e5f6a7-b8c9-0123-d456-789012345678",
    "numberId": "f7a8b9c0-d1e2-3456-f789-012345678901",
    "phoneNumber": "+4512345678",
    "numberType": "local",
    "organizationId": "b5e2d7f3-a1c4-4e89-9f6b-3d8a7c5e1024",
    "newSim": {
      "iccid": "8945000000000000002",
      "activationCode": "LPA:1$SMDP.TELGEA.COM$58214-90317-2261",
      "pinOne": "1234",
      "pinTwo": "5678",
      "pukOne": "12345678",
      "pukTwo": "87654321"
    }
  }
}
```

| Field                   | Type             | Description                                                               |
| ----------------------- | ---------------- | ------------------------------------------------------------------------- |
| `userId`                | `string`         | UUID of the user                                                          |
| `numberId`              | `string`         | UUID of the number whose SIM was replaced                                 |
| `phoneNumber`           | `string`         | Phone number in E.164 format, or an empty string when the number has none |
| `numberType`            | `string`         | `local` or `travel`                                                       |
| `organizationId`        | `string`         | UUID of your organization                                                 |
| `newSim.iccid`          | `string`         | ICCID of the new SIM                                                      |
| `newSim.activationCode` | `string \| null` | LPA activation string to render as a QR code                              |
| `newSim.pinOne`         | `string \| null` | PIN 1 code                                                                |
| `newSim.pinTwo`         | `string \| null` | PIN 2 code                                                                |
| `newSim.pukOne`         | `string \| null` | PUK 1 code                                                                |
| `newSim.pukTwo`         | `string \| null` | PUK 2 code                                                                |

See [Replace a SIM card](https://developer.telgea.com/docs/enterprise/api/user-plans#replace-a-sim-card) to start a replacement.