List custom actions

GET

custom-actions

curl -X GET "https://api.nedzo.ai/v1/custom-actions?workspaceId=789e4567-e89b-12d3-a456-426614174000" \
    -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "5a3c1e2b-8d7f-4b6a-9c0e-1f2a3b4c5d6e",
    "workspaceId": "789e4567-e89b-12d3-a456-426614174000",
    "name": "Check zip code",
    "condition": "The caller gives a zip code",
    "method": "POST",
    "url": "https://example.com/coverage",
    "parameters": [{ "name": "zip", "type": "string", "required": true }],
    "isActive": true,
    "authType": "bearer",
    "hasAuth": true,
    "headerNames": ["X-Team"],
    "createdAt": "2026-10-11T10:00:00Z",
    "updatedAt": "2026-10-11T10:00:00Z"
  }
]

This endpoint is for the VIP plan only. Other plans get a 403. See Plan access.

A custom action calls your endpoint during a conversation. It belongs to the workspace, so one action can serve many agents. See Actions for the request your endpoint gets.

Query Parameters

string

required

The workspace. Required.

curl -X GET "https://api.nedzo.ai/v1/custom-actions?workspaceId=789e4567-e89b-12d3-a456-426614174000" \
    -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "5a3c1e2b-8d7f-4b6a-9c0e-1f2a3b4c5d6e",
    "workspaceId": "789e4567-e89b-12d3-a456-426614174000",
    "name": "Check zip code",
    "condition": "The caller gives a zip code",
    "method": "POST",
    "url": "https://example.com/coverage",
    "parameters": [{ "name": "zip", "type": "string", "required": true }],
    "isActive": true,
    "authType": "bearer",
    "hasAuth": true,
    "headerNames": ["X-Team"],
    "createdAt": "2026-10-11T10:00:00Z",
    "updatedAt": "2026-10-11T10:00:00Z"
  }
]

Errors

Status	When
`400`	`workspaceId` is not a valid UUID.
`400`	`workspaceId is required`: `workspaceId` is missing.
`404`	The workspace is not in your API key’s scope.

curl -X GET "https://api.nedzo.ai/v1/custom-actions?workspaceId=789e4567-e89b-12d3-a456-426614174000" \
    -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "5a3c1e2b-8d7f-4b6a-9c0e-1f2a3b4c5d6e",
    "workspaceId": "789e4567-e89b-12d3-a456-426614174000",
    "name": "Check zip code",
    "condition": "The caller gives a zip code",
    "method": "POST",
    "url": "https://example.com/coverage",
    "parameters": [{ "name": "zip", "type": "string", "required": true }],
    "isActive": true,
    "authType": "bearer",
    "hasAuth": true,
    "headerNames": ["X-Team"],
    "createdAt": "2026-10-11T10:00:00Z",
    "updatedAt": "2026-10-11T10:00:00Z"
  }
]

API Reference

Workspaces

Agents

Phone Numbers

Contacts

Knowledge

Templates

Campaigns

Workflows

Conversations

List custom actions

Query Parameters

Errors