Agent settings

Test Webflow connection

POST /projects/{project_id}/agent/settings/test-webflow

Tests Webflow credentials and returns the collections available to those credentials. This endpoint performs a connection test only; it does not save the credentials.

Request body

Field	Type	Required	Description
`project_id`	string (UUID)	Yes	Same project ID used in the URL path
`site_id`	string	Yes	Webflow site ID
`api_token`	string	Yes	Webflow API token

curl -X POST "https://topify-customer-api-production.up.railway.app/api/public/v1/projects/{project_id}/agent/settings/test-webflow" \
  -H "X-API-Key: tk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "a1b2c3d4-...",
    "site_id": "65abc123...",
    "api_token": "webflow-token"
  }'

Response

{
  "success": true,
  "data": {
    "success": true,
    "error": null,
    "collections": [
      { "id": "collection-id", "title": "Blog posts" }
    ]
  }
}

Treat the Webflow token as a secret. Do not log it or include it in agent conversation history.

Error responses

Status	Cause
`400`	Missing project ID, site ID, API token, or invalid JSON
`403`	The API key’s team cannot access the project
`500`	Webflow rejected the credentials or the connection test failed

Actions Webhooks

Getting started

Authorized AI agent setup

Endpoints

Test Webflow connection

Request body

Response

Error responses

​Test Webflow connection

​Request body

​Response

​Error responses

Test Webflow connection

Request body

Response

Error responses