Show examples in:
JavascriptHTTP
Endpoint info
Available examples
Content Management API > Build trigger

Create build trigger

Body parameters

typestringRequired

Must be exactly "build_trigger".

attributes.namestringRequired

Name of the build trigger

Example:"Custom build trigger"
attributes.adapterenumRequired

The type of build trigger

Example:"custom"
customOptional

adapter_settings must include the following properties: trigger_url, headers and payload. The custom adapter also supports CircleCI webhooks for backward compatibility.

netlifyOptional

adapter_settings must include the following properties: trigger_url, access_token, branch, site_id

vercelOptional

adapter_settings must include the following properties: project_id, token, branch, team_id, deploy_hook_url

gitlabOptional

adapter_settings must include the following properties: trigger_url, token, ref, build_parameters

attributes.frontend_urlstring, nullRequired

The public URL of the frontend.

Example:"https://www.mywebsite.com/"
attributes.adapter_settingsobjectRequired

Additional settings for the build trigger. The value depends on the adapter.

Example:{ trigger_url: "http://some-url.com/trigger", headers: { Authorization: "Bearer abc123" }, payload: { type: "build_request" }, }
attributes.autotrigger_on_scheduled_publicationsbooleanRequired

Wheter an automatic build request to webhook_url should be made on scheduled publications/unpublishings

attributes.webhook_tokenstringOptional

Unique token for the webhook (it's the same token present in webhook_url)

Example:"xA1239ajsk123"
attributes.enabledbooleanOptional

Whether the build trigger is enabled or not

attributes.indexing_enabledbooleanDeprecated

Wether Site Search is enabled or not. With Site Search, everytime the website is built, DatoCMS will respider it to get updated content

Site Search features have been detached from build triggers. This attribute has no effect anymore: we keep it present for retrocompatibility. If you're programmatically using this field, please get in touch with support@datocms.com

Returns

Returns a resource object of type build_trigger.

Examples

POST https://site-api.datocms.com/build-triggers HTTP/1.1
Authorization: Bearer YOUR-API-TOKEN
Accept: application/json
X-Api-Version: 3
Content-Type: application/vnd.api+json
{
"data": {
"type": "build_trigger",
"attributes": {
"name": "Custom build trigger",
"adapter": "custom",
"frontend_url": "https://www.mywebsite.com/",
"adapter_settings": {
"trigger_url": "http://some-url.com/trigger",
"headers": {
"Authorization": "Bearer abc123"
},
"payload": {
"type": "build_request"
}
},
"autotrigger_on_scheduled_publications": true
}
}
}
Terminal window
curl -g 'https://site-api.datocms.com/build-triggers' \
-X POST \
-H "Authorization: Bearer YOUR-API-TOKEN" \
-H "Accept: application/json" \
-H "X-Api-Version: 3" \
-H "Content-Type: application/vnd.api+json" \
--data-binary '{"data":{"type":"build_trigger","attributes":{"name":"Custom build trigger","adapter":"custom","frontend_url":"https://www.mywebsite.com/","adapter_settings":{"trigger_url":"http://some-url.com/trigger","headers":{"Authorization":"Bearer abc123"},"payload":{"type":"build_request"}},"autotrigger_on_scheduled_publications":true}}}'
await fetch("https://site-api.datocms.com/build-triggers", {
method: "POST",
headers: {
Authorization: "Bearer YOUR-API-TOKEN",
Accept: "application/json",
"X-Api-Version": "3",
"Content-Type": "application/vnd.api+json",
},
body: JSON.stringify({
data: {
type: "build_trigger",
attributes: {
name: "Custom build trigger",
adapter: "custom",
frontend_url: "https://www.mywebsite.com/",
adapter_settings: {
trigger_url: "http://some-url.com/trigger",
headers: { Authorization: "Bearer abc123" },
payload: { type: "build_request" },
},
autotrigger_on_scheduled_publications: true,
},
},
}),
});
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: cache-control: max-age=0, private, must-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 28
{
"data": {
"type": "build_trigger",
"id": "1822",
"attributes": {
"name": "Custom build trigger",
"adapter": "custom",
"adapter_settings": {
"trigger_url": "http://some-url.com/trigger",
"headers": {
"Authorization": "Bearer abc123"
},
"payload": {
"type": "build_request"
}
},
"last_build_completed_at": "2017-03-30T09:29:14.872Z",
"build_status": "success",
"webhook_token": "xA1239ajsk123",
"webhook_url": "https://webhooks.datocoms.com/xA1239ajsk123/deploy-results",
"frontend_url": "https://www.mywebsite.com/",
"enabled": true,
"autotrigger_on_scheduled_publications": true
}
}
}