List extraction fields

GET

agents

{agentId}

extraction-fields

curl -X GET "https://api.nedzo.ai/v1/agents/123e4567-e89b-12d3-a456-426614174000/extraction-fields" \
    -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "2c4e6f80-1a3b-4c5d-8e9f-0a1b2c3d4e5f",
    "agentId": "123e4567-e89b-12d3-a456-426614174000",
    "name": "budget",
    "type": "number",
    "description": "The budget the caller gives, in dollars",
    "targetContactField": null,
    "targetCustomVariableId": "0e1f2a3b-4c5d-4e6f-8a9b-0c1d2e3f4a5b",
    "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.

After each conversation, the agent fills in its extraction fields. They show in the conversation log and in the post-conversation webhook, and each one saves its value to a custom field on the contact. First name, last name, email, phone and company are filled in on their own, so they need no field.

Path Parameters

string

required

Agent UUID

curl -X GET "https://api.nedzo.ai/v1/agents/123e4567-e89b-12d3-a456-426614174000/extraction-fields" \
    -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "2c4e6f80-1a3b-4c5d-8e9f-0a1b2c3d4e5f",
    "agentId": "123e4567-e89b-12d3-a456-426614174000",
    "name": "budget",
    "type": "number",
    "description": "The budget the caller gives, in dollars",
    "targetContactField": null,
    "targetCustomVariableId": "0e1f2a3b-4c5d-4e6f-8a9b-0c1d2e3f4a5b",
    "createdAt": "2026-10-11T10:00:00Z",
    "updatedAt": "2026-10-11T10:00:00Z"
  }
]

Errors

Status	When
`400`	`agentId` is not a valid UUID.
`404`	The agent is not in your API key’s scope.

curl -X GET "https://api.nedzo.ai/v1/agents/123e4567-e89b-12d3-a456-426614174000/extraction-fields" \
    -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "2c4e6f80-1a3b-4c5d-8e9f-0a1b2c3d4e5f",
    "agentId": "123e4567-e89b-12d3-a456-426614174000",
    "name": "budget",
    "type": "number",
    "description": "The budget the caller gives, in dollars",
    "targetContactField": null,
    "targetCustomVariableId": "0e1f2a3b-4c5d-4e6f-8a9b-0c1d2e3f4a5b",
    "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 extraction fields

Path Parameters

Errors