Context

When using a codemagic.yaml workflow with an Apple Developer Portal integration, you may encounter an error when setting auth: integration under publishing → app_store_connect. The error states that workflow → integrations → app_store_connect is required. This happens because the workflow needs an explicit integrations section that references your Developer Portal integration by its exact name.

Answer

To resolve this, you need to add an integrations section to your workflow in codemagic.yaml that references your Apple Developer Portal integration by its reference name. Follow these steps:

1. Go to Settings > General Settings > Integrations > Developer Portal > Manage Keys.

2. Click the copy button next to your integration to copy its exact reference name.

3. Add an integrations section to your workflow in codemagic.yaml, using that reference name as the value for app_store_connect.

Here is an example of a complete workflow configuration for publishing to TestFlight:

ios-release:
  name: iOS Release
  ...
  integrations:
    app_store_connect: Your API Key Name
  scripts:
    ...
  artifacts:
    - build/ios/ipa/*.ipa
  publishing:
    app_store_connect:
      auth: integration
      submit_to_testflight: true
      submit_to_app_store: false

Replace Your API Key Name with the exact reference name copied from your Developer Portal integration settings. The name must match precisely for the integration to be recognized.