Hanzo
PlatformHanzo KMSIntegrationsApp Connections

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

Netlify User Settings

Applications Tab

Provide a name for your token and generate it.

Token Form

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

Token Generated

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.

App Connections Tab

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

Select Netlify Connection

Complete the form by providing:

  • A descriptive name for the connection
  • An optional description
  • The API Token from the previous step

Netlify Connection Modal

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

Netlify Connection Created

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

On this page