Confirm ZCLI is authenticated with an administrator profile approved for public connector development, and that your ZCLI version includes connectors:encryption-key. If the key is reported as temporarily unavailable, retry later or contact Zendesk support. A failed download never overwrites a previously downloaded key file.
required directory 'assets/' not found or contains no files in bundle
The archive must contain at least one file under assets/ at the ZIP root (for example assets/logo.svg). An empty assets/ directory does not count. Connectors scaffolded with zcli connectors:create include assets/logo.svg by default - if you deleted it, restore it or add another asset file.
SyntaxError ... Unexpected token ILLEGAL during validation
The ZIP contains __MACOSX/ metadata shadowing connector.js, or connector.js is not JavaScript. Re-zip from the terminal and verify with unzip -l. See Package the connector bundle.
Version X must be greater than the latest released version Y
Bump the version in the manifest and rebuild.
Connector is already mapped to a different submission
The connector name is permanently bound to its original submission. Upload new versions through that submission - see Submitting a connector update.
The OAuth client settings conflict with the existing publisher OAuth client
client_id or grant_type changed after first approval. Restore the original values, or contact Zendesk support.
settings.json rejected
Keep only the authentication root property, and make sure the secret uses {"encrypted_value": "enc:v1:..."} - plaintext is rejected.
The encrypted value cannot be decrypted
Re-download the current key and re-encrypt. Confirm the script used RSA-OAEP-256/A256GCM, the SPKI SHA-256 fingerprint as kid, and authentication.client_secret as the payload field - and that the settings.json value starts with the enc:v1: prefix.
Authentication does not match the connector
Make type and grant_type identical in the connector declaration and settings.json; remove any authentication.client declaration from connector source.