Folk CRM Integration

ID Format

Folk IDs are a short prefix + UUID v4: per_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

The find_person tool returns IDs in this exact format:

{
  "found": true,
  "matches": [
    {"id": "per_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "name": "Full Name", "email": "..."}
  ],
  "total": 1
}

You must copy the id value exactly from the search result. If you do not have an ID from a search result in the current conversation, call find_person or find_company again.