Huawei authorization
Step-by-step guide to connect your Huawei app to OneSignal for push notifications, including PushKit setup, API key configuration, and Huawei’s optional message self-classification for apps with users in China.
Requirements
To enable push notifications on Huawei Android devices using OneSignal, you’ll need:- A Huawei Developer Account
- An Android mobile app registered in Huawei’s AppGallery Connect
- A OneSignal Account
- (Optional) Huawei Self-Classification Rights if targeting users in China and needing more precise message categorization via the
Huawei_categoryAPI field
Setup
1. Enable PushKit
Go to AppGallery Connect > Project Settings > PushKit and enable PushKit.2. Get your Huawei Push credentials
Open AppGallery Connect and select your app from the My Apps section.
Navigate to your App in AppGallery Connect
- Package Name
- Client ID
- Client Secret
Copy your Package Name, Client ID, and Client Secret
3. Add credentials to OneSignal
In the OneSignal dashboard, go to your app Settings > Push & In-App > Huawei Android (HMS).
Select Huawei Android in OneSignal
- Package Name
- Client ID (into App ID field)
- Client Secret (into App Secret field)
Enter Huawei Push credentials in OneSignal
4. (Optional) Apply for Huawei’s Self-Classification Rights
Huawei requires AppGallery apps sending notifications to users in China to categorize messages. They offer automatic classification, but self-classification gives more control and higher send limits for critical message types.How to apply
- Follow Huawei’s Self-Classification application guide.
- Once approved, use the
Huawei_categoryfield in the OneSignal API to classify your messages.
Supported Huawei_category values
| Category | Description |
|---|---|
IM | Instant messaging |
VOIP | Voice-over-IP services |
SUBSCRIPTION | Subscribed content notifications |
TRAVEL | Travel info (e.g., ticket updates) |
HEALTH | Health and wellness updates |
WORK | Work-related reminders |
ACCOUNT | Account activity alerts |
EXPRESS | Logistics/delivery updates |
FINANCE | Financial/banking alerts |
DEVICE_REMINDER | Device-level system reminders |
MAIL | Email client messages |
MARKETING | Marketing or promotional content |
Default category is
MARKETING, which is limited to 2–5 sends/day depending on third-level classifications.Important: Classification violations may lead to penalties or delivery restrictions.You’re now authorized to send Huawei push notifications using OneSignal!
Next steps: