| buildkite_api_access_token | Buildkite API Access Token | yes | — |
| pipeline | The pipeline to create a build on, in the format <org-slug>/<pipeline-slug>. Either this or pipeline_uuid must be provided. | no | — |
| pipeline_uuid | The UUID of the pipeline to create a build on. Use this instead of pipeline for a stable identifier that does not change when the pipeline is renamed. Either this or pipeline must be provided. | no | — |
| commit | The commit SHA of the build | no | HEAD |
| branch | The branch of the build | no | — |
| message | The message for the build | no | — |
| send_pull_request | Whether to set PULL_REQUEST_ID, which sets BUILDKITE_PULL_REQUEST on the build. Does not work for cross-repo builds. Defaults to true | no | — |
| pull_request_base_branch | For a pull request build, the base branch of the pull request. | no | — |
| build_env_vars | Additional environment variables to set on the build, in JSON format | no | — |
| build_meta_data | Meta-data to set on the build, in JSON format | no | — |
| ignore_pipeline_branch_filter | Ignore pipeline branch filtering when creating a new build. true or false | no | — |
| wait | Wait for the build to finish before completing. true or false | no | false |
| wait_interval | Interval in seconds between build status checks when waiting | no | 10 |
| wait_timeout | Maximum time in seconds to wait for build completion | no | 3600 |
| retry_max_attempts | Maximum number of retry attempts for API calls during build status polling (for transient failures like 5xx errors) | no | 5 |
| retry_base_delay | Base delay in seconds for exponential backoff between retry attempts | no | 2 |
| commit_author_name | Default commit author name to use if not available from event payload (useful for events without pusher field like status events) | no | — |
| commit_author_email | Default commit author email to use if not available from event payload (useful for events without pusher field like status events) | no | — |