- Networks
- Smart lighting and home hubs
Failed to add accessory
Aqara hub Failed to add accessory: HomeKit pairing error
Risk level
Low
Usually safe to check without specialist tools.
Urgency
Medium
Quick answer
When adding an Aqara Hub M2, Hub M1S Gen 2 or Camera Hub G3 fails with 'Failed to add accessory', restart your iOS device to clear cached error data, hold the hub button for over 10 seconds until yellow flashes quickly, and pair on 2.4 GHz Wi-Fi without special characters.
Safety first
Stop and check this first
- Keep the 8-digit HomeKit setup code printed on the hub or packaging in a safe place: Aqara notes that each product has a unique code required whenever you manually re-add the accessory.
- If adding the hub prompts 'the device has been added', delete the previously added hub in the Apple Home or Aqara Home app first before resetting the network; never attempt to bypass HomeKit or Aqara account pairing.
Safe checks you can perform
- Check 2.4 GHz Wi-Fi and remove special characters from SSID/password
- Restart the iOS device and reset the hub's network state
- Retry pairing and apply the manual HomeKit code follow-up
Leave these tasks to a qualified professional
- Do not attempt this professional task: Perform the iOS cache restart, hub reset and manual code entry
- Do not attempt this professional task: Inspect router AP isolation, connection watcher and bridge settings
What a technician must be able to justify
Technician visit
These are the steps they must carry out and show you. Tick them as they work: if steps are skipped, do not accept a part swap.
These are not instructions for opening or handling the equipment yourself. They are the checks that should support a technical conclusion.
Perform the iOS cache restart, hub reset and manual code entry
What they doThe professional coordinates restarting the iOS device and resetting the hub for 10 seconds, waits 3 minutes if 'Accessory not found' is shown, and completes pairing by manually entering the 8-digit HomeKit setup code.
They must show youthe hub successfully bound and visible inside both Apple Home and Aqara Home.
In writingiOS restart and hub reset steps completed, manual HomeKit code entry result and any router compatibility notes.
Inspect router AP isolation, connection watcher and bridge settings
What they doThe technician reviews router settings to ensure AP isolation and the Wi-Fi connection watcher (anti-squatter) feature are turned off, confirms the network is not bridged or using WAP/WAP2 enterprise security, and verifies LAN discovery.
They must show yourouter configuration with AP isolation and connection watcher disabled on the 2.4 GHz LAN.
In writinginspected router settings, changes made to SSID/password or isolation rules, and LAN discovery status.
Before accepting a part or repair
Nothing has been shown yet. Do not accept a part swap based on the code alone.
Follow these steps
Note: Follow the documented order. An error code identifies the affected system, but it does not prove by itself which part has failed.
Check 2.4 GHz Wi-Fi and remove special characters from SSID/password
- Who:
- you, reviewing the Wi-Fi network on your phone before attempting to add the Aqara hub.
- How:
- confirm that your phone is connected to a 2.4 GHz Wi-Fi network (disable 5 GHz on dual-band routers for Hub M2 and M1S Gen 2) and ensure the Wi-Fi name and password contain only ordinary alphanumeric characters without symbols such as @, #, %, - or $.
- Result that matters:
- remove the Wi-Fi credential and band mismatches that trigger repeated adding failures.
- If the Wi-Fi name or password contains special symbols or 5 GHz is active:
- update those router settings first.
- If the Wi-Fi network already meets those requirements:
- proceed to clear the iOS cache and reset the hub.
- Evidence to keep:
- active Wi-Fi band and confirmation that the SSID and password use ordinary characters only.
Evidence: Aqara Hub M2 Quick Start Guide / Manual de usuario de Hub M2 (HM2-G01) · Aqara Hub M1S Gen 2 Quick Start Guide / Guía rápida de Aqara Hub M1S Gen 2 (HM1S-G02) · Aqara Camera Hub G3 User Manual / Cámara Hub G3 Manual de Uso (CH-H03) · Aqara Support Center: Hub M2 FAQ (EN)
Restart the iOS device and reset the hub's network state
- Who:
- you, with your iPhone or iPad and access to the physical button on your Hub M2, M1S Gen 2 or Camera Hub G3.
- How:
- restart the iOS phone or tablet to clear the iOS error cache, then press and hold the hub button for more than 10 seconds until the yellow (or yellow/red on M2) indicator light flashes quickly.
- Result that matters:
- clear the cached iOS pairing error and return the hub to network-waiting status.
- If the iOS device has restarted and the hub indicator flashes yellow quickly:
- retry adding the hub in the app.
- If the Camera Hub G3 indicator is not yellow and flashing quickly on startup:
- press its function button rapidly 10 times as directed in the G3 manual.
- Evidence to keep:
- completed iOS restart and fast yellow flashing confirmed on the hub indicator.
Evidence: Aqara Hub M2 Quick Start Guide / Manual de usuario de Hub M2 (HM2-G01) · Aqara Hub M1S Gen 2 Quick Start Guide / Guía rápida de Aqara Hub M1S Gen 2 (HM1S-G02) · Aqara Camera Hub G3 User Manual / Cámara Hub G3 Manual de Uso (CH-H03) · Aqara Support Center: Hub M2 FAQ (EN)
Retry pairing and apply the manual HomeKit code follow-up
- Who:
- you, scanning or entering the 8-digit HomeKit setup code located on the hub base or manual.
- How:
- add the hub again in Aqara Home or Apple Home; if 'Accessory already added' appears after the restart and reset, manually enter the HomeKit setup code; if 'Accessory not found' appears, wait 3 minutes after resetting the hub and manually enter the code.
- Result that matters:
- complete HomeKit and Aqara Home binding using the documented recovery path for each prompt.
- If the hub binds and appears in Apple Home and Aqara Home:
- store the HomeKit setup code label in a safe place.
- If 'Failed to add accessory' returns after restarting iOS and waiting 3 minutes:
- have a technician inspect router AP isolation and compatibility.
- Evidence to keep:
- exact on-screen prompt after the retry and whether the hub appears in Apple Home and Aqara Home.
Evidence: Aqara Hub M2 Quick Start Guide / Manual de usuario de Hub M2 (HM2-G01) · Aqara Hub M1S Gen 2 Quick Start Guide / Guía rápida de Aqara Hub M1S Gen 2 (HM1S-G02) · Aqara Camera Hub G3 User Manual / Cámara Hub G3 Manual de Uso (CH-H03) · Aqara Support Center: Hub M2 FAQ (EN)
Still not solved
If the error persists, stop here. See what the technician must do and show you.
Where this code applies
A code is meaningful only inside the right product and version context.
Primary scope
- System
- Networks
- Brand
- Aqara
- Product type
- Smart lighting and home hubs
Known code variants
- Accessory failed to be added
- Error al añadir accesorio
- Failed to add to HomeKit
- No se pueden agregar accesorios
- No se pueden añadir accesorios
- Trouble adding to HomeKit
What it means
The official user manuals for Aqara Hub M2 (HM2-G01), Hub M1S Gen 2 (HM1S-G02) and Camera Hub G3 (CH-H03), together with the Hub M2 FAQ, document the prompt 'Failed to add accessory' ('Accessory failed to be added') under HomeKit and hub onboarding troubleshooting. They explain that after multiple adding failures, cached error information in iOS cannot be cleared automatically, requiring an iOS device restart, a hub reset and verification of router Wi-Fi settings. Other Aqara models may differ, and this message alone never proves that any hub hardware is defective.
Warnings and stop conditions
- Lowsource verified
Keep the 8-digit HomeKit setup code printed on the hub or packaging in a safe place: Aqara notes that each product has a unique code required whenever you manually re-add the accessory.
Evidence: Aqara Hub M2 Quick Start Guide / Manual de usuario de Hub M2 (HM2-G01) · Aqara Hub M1S Gen 2 Quick Start Guide / Guía rápida de Aqara Hub M1S Gen 2 (HM1S-G02) · Aqara Support Center: Hub M2 FAQ (EN)
- Mediumsource verified
If adding the hub prompts 'the device has been added', delete the previously added hub in the Apple Home or Aqara Home app first before resetting the network; never attempt to bypass HomeKit or Aqara account pairing.
Evidence: Aqara Support Center: Hub M2 FAQ (EN)
Symptoms and causes
Probable causes · in order
- Cached pairing error data stuck in the iOS systemCommon
The Hub M2, Hub M1S Gen 2 and Camera Hub G3 manuals state that after repeated adding failures, error information in the iOS cache cannot be removed without restarting the iOS device.
Evidence: Aqara Hub M2 Quick Start Guide / Manual de usuario de Hub M2 (HM2-G01) · Aqara Hub M1S Gen 2 Quick Start Guide / Guía rápida de Aqara Hub M1S Gen 2 (HM1S-G02) · Aqara Camera Hub G3 User Manual / Cámara Hub G3 Manual de Uso (CH-H03) · Aqara Support Center: Hub M2 FAQ (EN)
- Unsupported special characters in Wi-Fi credentials or 5 GHz bandPossible
Aqara notes that hub onboarding fails when the Wi-Fi SSID or password contains special symbols (@, #, %, -, $) or when a 2.4 GHz-only hub is paired while 5 GHz Wi-Fi is active.
Evidence: Aqara Hub M2 Quick Start Guide / Manual de usuario de Hub M2 (HM2-G01) · Aqara Hub M1S Gen 2 Quick Start Guide / Guía rápida de Aqara Hub M1S Gen 2 (HM1S-G02) · Aqara Camera Hub G3 User Manual / Cámara Hub G3 Manual de Uso (CH-H03) · Aqara Support Center: Hub M2 FAQ (EN)
- Router AP isolation, connection watcher or bridge network activePossible
The setup guides warn that AP isolation prevents the phone from finding the hub on the LAN, while Wi-Fi connection watcher (anti-squatter), bridge networks or WAP/WAP2 block connection.
Evidence: Aqara Hub M2 Quick Start Guide / Manual de usuario de Hub M2 (HM2-G01) · Aqara Hub M1S Gen 2 Quick Start Guide / Guía rápida de Aqara Hub M1S Gen 2 (HM1S-G02) · Aqara Camera Hub G3 User Manual / Cámara Hub G3 Manual de Uso (CH-H03) · Aqara Support Center: Hub M2 FAQ (EN)
Virtual technician
Does Failed to add accessory still appear after these checks?
Answer a few questions to narrow down the likely cause and the safest next action. Guidance only - it never replaces a professional.
Sources and technical references
- 1
Aqara Hub M2 Quick Start Guide / Manual de usuario de Hub M2 (HM2-G01)
Aqara · 2026 · official_doc
- 2
Aqara Hub M1S Gen 2 Quick Start Guide / Guía rápida de Aqara Hub M1S Gen 2 (HM1S-G02)
Aqara · 2026 · official_doc
- 3
Aqara Camera Hub G3 User Manual / Cámara Hub G3 Manual de Uso (CH-H03)
Aqara · 2026 · official_doc
- 4
Aqara Support Center: Hub M2 FAQ (EN)
Aqara · 2026 · official_doc
- 5
Centro de soporte de Aqara: Preguntas frecuentes de Hub M2 (ES)
Aqara · 2026 · official_doc
Was this entry useful?