v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1445247249.8 KB

For an existing CodeBuild build project that has its source code stored in a GitHub or Bitbucket repository, enables CodeBuild to start rebuilding the source code every time a code change is pushed to the repository.

If you enable webhooks for an CodeBuild project, and the project is used as a build step in CodePipeline, then two identical builds are created for each commit. One build is triggered through webhooks, and one through CodePipeline. Because billing is on a per-build basis, you are billed for both builds. Therefore, if you are using CodePipeline, we recommend that you disable webhooks in CodeBuild. In the CodeBuild console, clear the Webhook box. For more information, see step 5 in Change a Build Project's Settings.

post/#X-Amz-Target=CodeBuild_20161006.CreateWebhook

Headers

X-Amz-Target'CodeBuild_20161006.CreateWebhook' required

Request body

projectNamestring required

The name of the CodeBuild project.

branchFilterstring
<p>A regular expression used to determine which repository branches are built when a webhook is triggered. If the name of a branch matches the regular expression, then it is built. If <code>branchFilter</code> is empty, then all branches are built.</p> <note> <p>It is recommended that you use <code>filterGroups</code> instead of <code>branchFilter</code>. </p> </note>
buildType'BUILD' | 'BUILD_BATCH'

Specifies the type of build this webhook will trigger.

Response

Success