Netlify Connection
Learn how to configure a Netlify Connection for Hanzo KMS.
Hanzo KMS supports the use of Personal Access Tokens to connect with Netlify.
Netlify requires the token to have full access to enable secret management for your sites and services.
Create a Netlify Personal Access Token


Provide a name for your token and generate it.

Make sure to copy the token now—you won’t be able to access it again.

Create a Netlify Connection in Hanzo KMS
In your Hanzo KMS dashboard, navigate to the Integrations tab in the desired project, then select App Connections.

Click + Add Connection and choose Netlify Connection from the list of integrations.

Complete the form by providing:
- A descriptive name for the connection
- An optional description
- The API Token from the previous step

After submitting the form, your Netlify Connection will be successfully created and ready to use with your Hanzo KMS project.

To create a Netlify Connection via API, send a request to the Create Netlify Connection endpoint.
Sample request
curl --request POST \
--url https://app.kms.hanzo.ai/api/v1/app-connections/netlify \
--header 'Content-Type: application/json' \
--data '{
"name": "my-netlify-connection",
"method": "access-token",
"projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
"credentials": {
"accessToken": "[ACCESS TOKEN]"
}
}'Sample response
{
"appConnection": {
"id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"name": "my-netlify-connection",
"description": null,
"projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
"version": 1,
"orgId": "abcdef12-3456-7890-abcd-ef1234567890",
"createdAt": "2025-07-19T10:15:00.000Z",
"updatedAt": "2025-07-19T10:15:00.000Z",
"isPlatformManagedCredentials": false,
"credentialsHash": "d41d8cd98f00b204e9800998ecf8427e",
"app": "netlify",
"method": "access-token",
"credentials": {}
}
}How is this guide?
Last updated on