How do I fix 401 Unauthorized errors when registering devices on iOS with the OutSystems plugin?

If you are encountering 401 Unauthorized errors when your OutSystems application tries to register an iOS device with Pushwoosh, the cause is a missing Device API Token — recent iOS SDKs require this token to authenticate registration calls.

Note: the Pushwoosh OutSystems plugin does not expose a setApiToken client action — the published client actions reference only lists RegisterDevice and the tag/inbox actions. On iOS this token is supplied to the underlying native SDK as an Info.plist entry, the same way it is for every other Pushwoosh iOS integration.

Follow these steps to resolve the issue:

1. Update the Plugin: use the latest Pushwoosh plugin version from the OutSystems Forge.
2. Get your Device API Token: in the Pushwoosh Control Panel, go to Settings → API Access and copy a token of type Device API Token scoped to the application you are integrating (account-level tokens, but scoped per app). Do not use a Server API Token.
3. Add the token to your iOS build's Info.plist: via your module's Extensibility Configurations (the same mechanism used to set preferences such as aps-environment for this plugin), add the key Pushwoosh_API_TOKEN with the token as its value. If your Extensibility Configurations setup does not carry this key through to the generated Info.plist, open a ticket with Pushwoosh support — the exact plugin syntax for this key is not publicly documented.
4. Verify Credentials: double-check the correct Pushwoosh Application Code and the Device API Token for the specific application (development vs. production).