Codebuild - How to trigger a build from an outbound webhook from external system not (bitbucket, github, gitlab)

Question

We just started to replace our bitbucket pipelines for AWS Codebuild.   One feature common to Bitbucket Pipeline and GitHub Actions, is there's an API to trigger a build.

This is quite useful when outbound webhooks fire from external system events not coming from the source control provider.

As an example, we are using pact.io for contract testing.   The pact broker will fire a webhook to trigger a build when a certain event occurs.   Pact.io has lots of documentation for CI build tools and this is easily replicated when using bitbucket pipelines or github actions.  However, I cannot seem to locate any documentation on how to trigger a Codebuild from an API Request.   See pact webhook templates for trigger_build examples of many CI tools, https://docs.pact.io/pact_broker/webhooks/template_library.

How can triggering a build be easily done with AWS Codebuild?

Answer

You can use [StartBuild API](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuild.html) in CodeBuild to start a build programmatically. Other API actions can be found in the same documentation. If a client has IAM credentials to make the API call, you can use CLI/SDK to make that API call. If not, you can consider building an API in API Gateway as a proxy for that CodeBuild API. See [this article](https://aws.amazon.com/premiumsupport/knowledge-center/api-gateway-proxy-integrate-service/) for reference.

Codebuild - How to trigger a build from an outbound webhook from external system not (bitbucket, github, gitlab)

Relevant content