Propstack MCP by usefulapi
Read Propstack contacts, properties, projects, deals, tasks, events; create and update CRM records.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~6,801토큰 (도구 정의)
~3.4 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 5.31%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"propstack": {
"url": "https://propstack.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://propstack.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (18)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢propstack_list_contacts(query, email, phone_number, status_ids, source_ids, ...)
List or search CRM contacts (Kontakte). Returns business fields only (name, company, email, phone numbers, status, source, tags, owner, dates), never birth data, identity or tax numbers, income or portal tokens. Search by free text (name, email, address, phone), exact email, exact phone number, or filter by status, source, tag, owner and dates. Archived contacts are excluded unless archived is set. GET /contacts.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"description": "Free-text search over first name, last name, emails, address and phone numbers.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"description": "Exact email address of the contact.",
"type": "string",
"minLength": 1,
"maxLength": 254
},
"phone_number": {
"description": "Exact phone number (spaces and dashes are ignored).",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"status_ids": {
"description": "Only contacts with one of these contact-status ids.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"source_ids": {
"description": "Only contacts from one of these source ids (see propstack_get_reference_data contact_sources).",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"tag_ids": {
"description": "Only contacts with these tag (Merkmal) ids (see propstack_get_reference_data contact_tags).",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"broker_id": {
"description": "Only contacts looked after by this user id (see propstack_list_users).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"archived": {
"description": "'only' = only archived contacts, 'include' = archived and active. Default: active only.",
"type": "string",
"enum": [
"only",
"include"
]
},
"include_children": {
"description": "Also return sub-contacts (contact persons of a company).",
"type": "boolean"
},
"sort_by": {
"description": "Sort field.",
"type": "string",
"enum": [
"last_contact_at",
"created_at",
"updated_at",
"first_name",
"last_name"
]
},
"order": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"created_after": {
"description": "Only contacts created at or after this ISO 8601 date-time.",
"type": "string"
},
"created_before": {
"description": "Only contacts created at or before this ISO 8601 date-time.",
"type": "string"
},
"updated_after": {
"description": "Only contacts updated at or after this ISO 8601 date-time.",
"type": "string"
},
"updated_before": {
"description": "Only contacts updated at or before this ISO 8601 date-time.",
"type": "string"
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_get_contact(contact_id, custom_fields, include)
One contact by id with address, salutation, language, notes, GDPR status, owner, status, source, tags, sub-contacts and owned properties. Birth data, identity and tax numbers, income and the portal token are never returned. GET /contacts/{id}.
입력 스키마
{
"type": "object",
"properties": {
"contact_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Propstack contact id."
},
"custom_fields": {
"description": "Names of custom fields to return (only these; sensitive ones such as birth date or income are never returned).",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"include": {
"description": "Related records to include: sub-contacts and/or properties the contact owns.",
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"children",
"owned_properties"
]
}
}
},
"required": [
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_list_properties(query, status_ids, tag_ids, project_id, marketing_type, ...)
List or search properties (Objekte / units): address, type, marketing type (buy/rent), rooms, areas, prices, status. Images and owners are not returned. Filter by free text, status, tag, project, marketing type, object type, price and area ranges. GET /units.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"description": "Free-text search over unit id, street, zip code, city, district and exposee id.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status_ids": {
"description": "Only properties in one of these status ids (see propstack_get_reference_data property_statuses).",
"minItems": 1,
"maxItems": 30,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"tag_ids": {
"description": "Only properties with one of these tag ids (see propstack_get_reference_data property_tags).",
"minItems": 1,
"maxItems": 30,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"project_id": {
"description": "Only the units of this project id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"marketing_type": {
"description": "Sale or rent.",
"type": "string",
"enum": [
"BUY",
"RENT"
]
},
"rs_type": {
"description": "Property type.",
"type": "string",
"enum": [
"APARTMENT",
"HOUSE",
"TRADE_SITE",
"GARAGE",
"SHORT_TERM_ACCOMODATION",
"OFFICE",
"GASTRONOMY",
"INDUSTRY",
"STORE",
"SPECIAL_PURPOSE",
"INVESTMENT"
]
},
"country": {
"description": "Two-letter ISO country code, e.g. DE.",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"archived": {
"description": "'only' = only archived properties, 'include' = archived and active. Default: active only.",
"type": "string",
"enum": [
"only",
"include"
]
},
"price_from": {
"description": "Minimum purchase price.",
"type": "number",
"minimum": 0
},
"price_to": {
"description": "Maximum purchase price.",
"type": "number",
"minimum": 0
},
"base_rent_from": {
"description": "Minimum cold rent.",
"type": "number",
"minimum": 0
},
"base_rent_to": {
"description": "Maximum cold rent.",
"type": "number",
"minimum": 0
},
"living_space_from": {
"description": "Minimum living space in square metres.",
"type": "number",
"minimum": 0
},
"living_space_to": {
"description": "Maximum living space in square metres.",
"type": "number",
"minimum": 0
},
"rooms_from": {
"description": "Minimum number of rooms.",
"type": "number",
"minimum": 0
},
"rooms_to": {
"description": "Maximum number of rooms.",
"type": "number",
"minimum": 0
},
"sort_by": {
"description": "Sort field.",
"type": "string",
"enum": [
"created_at",
"updated_at",
"price",
"base_rent",
"property_space_value",
"number_of_rooms",
"construction_year"
]
},
"order": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_get_property(property_id)
One property (Objekt) by id: address, type, rooms, areas, prices, status and the description, location and furnishing texts (clipped). No images or owner. GET /units/{id}.
입력 스키마
{
"type": "object",
"properties": {
"property_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Propstack property id."
}
},
"required": [
"property_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_list_projects
List projects (Projekte: a project groups several property units): title, project id, status, address, owner. Not paged; at most 200 are returned. GET /projects.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_list_deals(deal_pipeline_id, deal_stage_ids, category, contact_id, property_id, ...)
List deals (a deal links a contact to a property and sits in a pipeline stage). Filter by pipeline, stage, category (qualified/unqualified/lost), contact, property, project or owner. Use propstack_list_deal_pipelines for stage ids. GET /client_properties.
입력 스키마
{
"type": "object",
"properties": {
"deal_pipeline_id": {
"description": "Only deals in this pipeline.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"deal_stage_ids": {
"description": "Only deals in these stages.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"category": {
"description": "Deal category.",
"type": "string",
"enum": [
"qualified",
"unqualified",
"lost"
]
},
"contact_id": {
"description": "Only the deals of this contact.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"property_id": {
"description": "Only the deals of this property.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"project_id": {
"description": "Only the deals of this project.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"broker_id": {
"description": "Only deals owned by this user id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"created_after": {
"description": "Only deals created at or after this ISO 8601 date-time.",
"type": "string"
},
"created_before": {
"description": "Only deals created at or before this ISO 8601 date-time.",
"type": "string"
},
"include_contact": {
"description": "Embed a short contact record in each deal (default false).",
"type": "boolean"
},
"include_property": {
"description": "Embed a short property record in each deal (default false).",
"type": "boolean"
},
"sort_by": {
"description": "Sort field (default created_at).",
"type": "string",
"pattern": "^[a-z_]{1,40}$"
},
"order": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_list_deal_pipelines
List the deal pipelines with their stages (id, name, position, win chance). Use the stage ids to filter deals or to move a deal. GET /deal_pipelines.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_list_activities(item_type, contact_id, property_id, project_id, broker_id, ...)
List the activity timeline (notes, tasks, appointments, e-mails, SMS, letters, rejections, inquiries) with title, linked contacts and properties, state and dates. Message and note bodies are not returned. Filter by type, contact, property, project, owner, category or date. GET /activities.
입력 스키마
{
"type": "object",
"properties": {
"item_type": {
"description": "Kind of activity; 'reminder' is a to-do.",
"type": "string",
"enum": [
"message",
"note",
"reminder",
"event",
"policy",
"cancelation",
"decision",
"sms",
"letter"
]
},
"contact_id": {
"description": "Only activities linked to this contact.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"property_id": {
"description": "Only activities linked to this property.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"project_id": {
"description": "Only activities linked to this project.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"broker_id": {
"description": "Only activities assigned to this user id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"category_id": {
"description": "Only this activity type id (see propstack_get_reference_data activity_types).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"only_inquiries": {
"description": "Only inquiries (Anfragen).",
"type": "boolean"
},
"starts_after": {
"description": "Only activities that start at or after this ISO 8601 date-time.",
"type": "string"
},
"starts_before": {
"description": "Only activities that start at or before this ISO 8601 date-time.",
"type": "string"
},
"created_after": {
"description": "Only activities created at or after this ISO 8601 date-time.",
"type": "string"
},
"created_before": {
"description": "Only activities created at or before this ISO 8601 date-time.",
"type": "string"
},
"order": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_get_task(task_id)
One task by id (a note, to-do or appointment): title, body text (clipped), type, linked contacts, properties and projects (id and name only), due date or start/end. GET /tasks/{id}.
입력 스키마
{
"type": "object",
"properties": {
"task_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Propstack task id (the id of a note, to-do or appointment)."
}
},
"required": [
"task_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_list_events(starts_after, starts_before, broker_id, contact_id, property_id, ...)
List calendar appointments (Termine, e.g. viewings) in a time window, with title, place, start/end, state and the linked contact, property and project (id and name only). Paged: follow next_page. GET /events.
입력 스키마
{
"type": "object",
"properties": {
"starts_after": {
"description": "Only events that start after this ISO 8601 date-time.",
"type": "string"
},
"starts_before": {
"description": "Only events that start before this ISO 8601 date-time.",
"type": "string"
},
"broker_id": {
"description": "Only events assigned to this user id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"contact_id": {
"description": "Only events with this contact.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"property_id": {
"description": "Only events for this property.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"project_id": {
"description": "Only events for this project.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"state": {
"description": "Event state.",
"type": "string",
"enum": [
"neutral",
"took_place",
"cancelled"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_list_users
List the users (staff, Nutzer) of the Propstack account: id, name, work email, position, phone, team. Use the ids as owner/broker filters. GET /brokers.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢propstack_get_reference_data(kind)
Look up the ids used by other tools: property_statuses, activity_types (note/task/appointment types, needed as note_type_id), contact_sources, reservation_reasons (rejection reasons), contact_tags or property_tags. GET /property_statuses, /activity_types, /contact_sources, /reservation_reasons or /groups.
입력 스키마
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"property_statuses",
"activity_types",
"contact_sources",
"reservation_reasons",
"contact_tags",
"property_tags"
],
"description": "Which list to fetch."
}
},
"required": [
"kind"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴propstack_create_contact(first_name, last_name, email, salutation, academic_title, ...)
WRITE: create a CRM contact. Propstack matches on the email address: if a contact with the same email already exists it is UPDATED with the given fields instead of creating a duplicate. Consent flags (newsletter, contact permission, GDPR status) cannot be set here. Returns the contact id. POST /contacts.
입력 스키마
{
"type": "object",
"properties": {
"first_name": {
"description": "First name.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"last_name": {
"description": "Last name.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"email": {
"description": "Primary email address.",
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"salutation": {
"description": "Salutation: mr or ms.",
"type": "string",
"enum": [
"mr",
"ms"
]
},
"academic_title": {
"description": "Academic title, e.g. Dr.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"company": {
"description": "Company the contact works for.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"position": {
"description": "Position in the company.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"is_company": {
"description": "True if the contact is a company.",
"type": "boolean"
},
"home_cell": {
"description": "Mobile number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"home_phone": {
"description": "Landline number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"office_phone": {
"description": "Business phone number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"office_cell": {
"description": "Business mobile number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"description": {
"description": "Internal note on the contact.",
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"language": {
"description": "Contact language.",
"type": "string",
"enum": [
"de",
"en",
"es"
]
},
"client_status_id": {
"description": "Contact status id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"client_source_id": {
"description": "Contact source id (see propstack_get_reference_data contact_sources).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"broker_id": {
"description": "User id of the person looking after the contact.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"custom_fields": {
"description": "Custom field values by field name; only the given fields change.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴propstack_update_contact(contact_id, first_name, last_name, email, salutation, ...)
WRITE: change the given fields of an existing contact; fields not given stay as they are. Returns the updated contact (business fields). PUT /contacts/{id}.
입력 스키마
{
"type": "object",
"properties": {
"contact_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Propstack contact id."
},
"first_name": {
"description": "First name.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"last_name": {
"description": "Last name.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"email": {
"description": "Primary email address.",
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"salutation": {
"description": "Salutation: mr or ms.",
"type": "string",
"enum": [
"mr",
"ms"
]
},
"academic_title": {
"description": "Academic title, e.g. Dr.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"company": {
"description": "Company the contact works for.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"position": {
"description": "Position in the company.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"is_company": {
"description": "True if the contact is a company.",
"type": "boolean"
},
"home_cell": {
"description": "Mobile number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"home_phone": {
"description": "Landline number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"office_phone": {
"description": "Business phone number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"office_cell": {
"description": "Business mobile number.",
"type": "string",
"minLength": 1,
"maxLength": 40
},
"description": {
"description": "Internal note on the contact.",
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"language": {
"description": "Contact language.",
"type": "string",
"enum": [
"de",
"en",
"es"
]
},
"client_status_id": {
"description": "Contact status id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"client_source_id": {
"description": "Contact source id (see propstack_get_reference_data contact_sources).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"broker_id": {
"description": "User id of the person looking after the contact.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"custom_fields": {
"description": "Custom field values by field name; only the given fields change.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
}
},
"required": [
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴propstack_create_task(kind, title, note_type_id, body, contact_ids, ...)
WRITE: create a note, a to-do (with due date) or an appointment (with start and end) in Propstack, linked to contacts, properties or projects. note_type_id is the activity type id (see propstack_get_reference_data activity_types). No e-mail or SMS is sent to the contact; the only mail is the reminder to the assignee when remind_at is set. Returns the new task id. POST /tasks.
입력 스키마
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"note",
"todo",
"appointment"
],
"description": "note = plain note, todo = task with due_date, appointment = event with starts_at and ends_at."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 250,
"description": "Title."
},
"note_type_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Activity type id; must match the kind (see propstack_get_reference_data activity_types)."
},
"body": {
"description": "Note text (plain text; stored as escaped HTML with line breaks).",
"type": "string",
"minLength": 1,
"maxLength": 20000
},
"contact_ids": {
"description": "Contacts the activity is linked to (usually one).",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"property_ids": {
"description": "Properties the activity is linked to.",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"project_ids": {
"description": "Projects the activity is linked to.",
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"broker_id": {
"description": "User id the task is assigned to.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"due_date": {
"description": "Due date and time (todo only).",
"type": "string"
},
"remind_at": {
"description": "When Propstack e-mails a reminder to the assignee, before due_date (todo only). This sends a mail to a colleague.",
"type": "string"
},
"starts_at": {
"description": "Start (appointment only).",
"type": "string"
},
"ends_at": {
"description": "End (appointment only).",
"type": "string"
},
"location": {
"description": "Place (appointment only).",
"type": "string",
"minLength": 1,
"maxLength": 300
}
},
"required": [
"kind",
"title",
"note_type_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴propstack_update_task(task_id, title, body, broker_id, done, ...)
WRITE: change the given fields of an existing note, to-do or appointment (for example mark a to-do done, move its due date, or reschedule). Fields not given stay as they are. PUT /tasks/{id}.
입력 스키마
{
"type": "object",
"properties": {
"task_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Propstack task id."
},
"title": {
"description": "Title.",
"type": "string",
"minLength": 1,
"maxLength": 250
},
"body": {
"description": "Note text (plain text; stored as escaped HTML with line breaks).",
"type": "string",
"minLength": 1,
"maxLength": 20000
},
"broker_id": {
"description": "User id the task is assigned to.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"done": {
"description": "Mark a to-do done (true) or open (false).",
"type": "boolean"
},
"due_date": {
"description": "New due date and time (to-do).",
"type": "string"
},
"remind_at": {
"description": "New reminder time (to-do).",
"type": "string"
},
"starts_at": {
"description": "New start (appointment).",
"type": "string"
},
"ends_at": {
"description": "New end (appointment).",
"type": "string"
},
"location": {
"description": "New place (appointment).",
"type": "string",
"minLength": 1,
"maxLength": 300
}
},
"required": [
"task_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴propstack_create_deal(contact_id, property_id, deal_stage_id, broker_id, price, ...)
WRITE: create a deal linking a contact to a property in a pipeline stage (see propstack_list_deal_pipelines for stage ids). Returns the new deal. POST /client_properties.
입력 스키마
{
"type": "object",
"properties": {
"contact_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Contact (prospect) id."
},
"property_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Property id."
},
"deal_stage_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Pipeline stage id."
},
"broker_id": {
"description": "User id of the deal owner.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"price": {
"description": "Expected price of the deal.",
"type": "number",
"minimum": 0
},
"note": {
"description": "Internal note on the deal.",
"type": "string",
"minLength": 1,
"maxLength": 5000
}
},
"required": [
"contact_id",
"property_id",
"deal_stage_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴propstack_update_deal(deal_id, deal_stage_id, broker_id, price, note)
WRITE: change the given fields of a deal, typically move it to another pipeline stage or update its note or price. Fields not given stay as they are. PUT /client_properties/{id}.
입력 스키마
{
"type": "object",
"properties": {
"deal_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Propstack deal id."
},
"deal_stage_id": {
"description": "Move the deal to this stage.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"broker_id": {
"description": "New deal owner (user id).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"price": {
"description": "Expected price of the deal.",
"type": "number",
"minimum": 0
},
"note": {
"description": "Internal note on the deal (replaces the previous note).",
"type": "string",
"minLength": 1,
"maxLength": 5000
}
},
"required": [
"deal_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 18개