Example usage of credentials parameters in declarative pipelines

Jenkinsfile

pipeline {
  agent any
  // user credentials as build parameters
  /*
  parameters {
    credentials(credentialType: 'com.cloudbees.plugins.credentials.impl.UsernamePasswordCredentialsImpl',
                defaultValue: '',
                description: 'Production deployment key',
                name: 'deployKey',
                required: true)
  }
  */
  stages {
    stage('Build') {
      steps {
        sh './build.sh'
      }
    }
    stage('Deploy') {
      // user credentials as an input step (doesn't prompt for credentials until executing this stage)
      input {
        message 'Select deployment credentials'
        parameters {
          credentials(credentialType: 'com.cloudbees.plugins.credentials.impl.UsernamePasswordCredentialsImpl',
                      defaultValue: '',
                      description: 'Production deployment key',
                      name: 'deployKey',
                      required: true)
        }
      }
      environment {
        DEPLOY_KEY = credentials('deployKey')
      }
      steps {
        sh 'curl -u "$DEPLOY_KEY" -XPOST https://webhooks.example.com/promote/'
      }
    }
  }
}