TelgeaDevelopers

SimReplaced

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

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

{
  "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"
    }
  }
}
FieldTypeDescription
userIdstringUUID of the user
numberIdstringUUID of the number whose SIM was replaced
phoneNumberstringPhone number in E.164 format, or an empty string when the number has none
numberTypestringlocal or travel
organizationIdstringUUID of your organization
newSim.iccidstringICCID of the new SIM
newSim.activationCodestring | nullLPA activation string to render as a QR code
newSim.pinOnestring | nullPIN 1 code
newSim.pinTwostring | nullPIN 2 code
newSim.pukOnestring | nullPUK 1 code
newSim.pukTwostring | nullPUK 2 code

See Replace a SIM card to start a replacement.

On this page