Change scenario
You’d like to add, remove, or change an optional input field to be required in your current authentication schema.Impact to users
This will cause a breaking change which will have the following significant effects to users:- Existing connected accounts will not work: All existing connected accounts will no longer be functional with your integration until users re-authenticate manually.
- Manual updates are required for all Zaps: Zaps cannot be migrated due to a breaking change, users will have to edit each Zap individually before they can start running tasks again. For example, if a user has 20 Zaps set up with your integration, they will need to manually update each one of those Zaps.
Best practices
- Add the field as optional: Use field [help text](/ and custom error handling (if you’re using our Code Mode or the CLI platform) to validate that the newly required field is provided, while keeping it set to optional. Also, consider using custom code to set the field’s default value in your API call if left blank.
- Set a default value: If possible, provide a default value for the required field that can be overwritten if necessary. This ensures that users who do not provide explicit values for these fields can continue to use your integration without issues.
Need help? Tell us about your problem and we’ll connect you with the right resource or contact support.