Support

Tickets to PropZolo support: open one, follow the thread, reply with screenshots, mark it solved.

GET/v1/support/tickets

Your support tickets

Latest activity first. `scope=company` lists every ticket of the company (Owners and Admins — privacy.support_access).

Access: Signed-in members only (web or Android session) — not for API keys.

Parameters

scopequery: "mine" | "company"
statusquery: "active" | "all" | "open" | "pending" | "solved" | "closed"
cursorquery: string
limitquery: integer

Response · 200

datarequired: array of SupportTicket
metarequired: PageMeta

Request

curl -X GET 'https://api.propzolo.com/v1/support/tickets' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": [
    {
      "id": "cmusrceel0000q7kaafxqi1om",
      "number": 0,
      "ref": "string",
      "subject": "string",
      "category": "how_to",
      "priority": "low",
      "status": "open",
      "requester": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "name": "string",
        "role": "string"
      },
      "mine": true,
      "first_response_due_at": "2026-10-06T05:30:00.000Z",
      "first_responded_at": "2026-10-06T05:30:00.000Z",
      "first_response": "met",
      "last_message_at": "2026-10-06T05:30:00.000Z",
      "last_message_by": "member",
      "solved_at": "2026-10-06T05:30:00.000Z",
      "created_at": "2026-10-06T05:30:00.000Z"
    }
  ],
  "meta": {
    "next_cursor": "string",
    "has_more": true
  }
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/support/tickets

Ask PropZolo support

Opens a ticket; the first-response target follows your plan and the priority you choose.

Access: Signed-in members only (web or Android session) — not for API keys.

Parameters

Idempotency-Keyheader: string
Unique key (a UUID) per logical request. A retry with the same key and body replays the first response for 24 hours (marked Idempotent-Replayed: true); the same key with another body is a 409.

Request body

subjectrequired: string
bodyrequired: string
categoryrequired: SupportTicketCategory
priority: SupportTicketPriority
attachments: array of object
attachments[].keyrequired: string
attachments[].filenamerequired: string
attachments[].content_typerequired: "image/jpeg" | "image/png" | "image/webp" | "application/pdf"
context: object
Where you were when you asked (filled in by the app).
context.path: string
context.app_version: string
context.user_agent: string

Response · 201

datarequired: SupportTicketDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/support/tickets' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Idempotency-Key: 6c0f1d3e-…' \
  -H 'Content-Type: application/json' \
  -d '{"subject":"string","body":"string","category":"how_to","priority":"low","attachments":[],"context":{"path":"string","app_version":"string","user_agent":"string"}}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "number": 0,
    "ref": "string",
    "subject": "string",
    "category": "how_to",
    "priority": "low",
    "status": "open",
    "requester": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string",
      "role": "string"
    },
    "mine": true,
    "first_response_due_at": "2026-10-06T05:30:00.000Z",
    "first_responded_at": "2026-10-06T05:30:00.000Z",
    "first_response": "met",
    "last_message_at": "2026-10-06T05:30:00.000Z",
    "last_message_by": "member",
    "solved_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "messages": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "author_kind": "member",
        "author_name": "string",
        "mine": true,
        "body": "string",
        "attachments": [
          {
            "key": "string",
            "filename": "string",
            "content_type": "string",
            "size": 0,
            "url": "string"
          }
        ],
        "created_at": "2026-10-06T05:30:00.000Z"
      }
    ]
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/support/tickets/{id}

A ticket and its thread

Access: Signed-in members only (web or Android session) — not for API keys.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: SupportTicketDetail
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/support/tickets/{id}' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "number": 0,
    "ref": "string",
    "subject": "string",
    "category": "how_to",
    "priority": "low",
    "status": "open",
    "requester": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string",
      "role": "string"
    },
    "mine": true,
    "first_response_due_at": "2026-10-06T05:30:00.000Z",
    "first_responded_at": "2026-10-06T05:30:00.000Z",
    "first_response": "met",
    "last_message_at": "2026-10-06T05:30:00.000Z",
    "last_message_by": "member",
    "solved_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "messages": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "author_kind": "member",
        "author_name": "string",
        "mine": true,
        "body": "string",
        "attachments": [
          {
            "key": "string",
            "filename": "string",
            "content_type": "string",
            "size": 0,
            "url": "string"
          }
        ],
        "created_at": "2026-10-06T05:30:00.000Z"
      }
    ]
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/support/tickets/{id}/messages

Reply in a ticket

The ticket goes back to PropZolo; a solved ticket reopens. A closed ticket answers 409.

Access: Signed-in members only (web or Android session) — not for API keys.

Parameters

idpathrequired: Id
Opaque record id.
Idempotency-Keyheader: string
Unique key (a UUID) per logical request. A retry with the same key and body replays the first response for 24 hours (marked Idempotent-Replayed: true); the same key with another body is a 409.

Request body

bodyrequired: string
attachments: array of object
attachments[].keyrequired: string
attachments[].filenamerequired: string
attachments[].content_typerequired: "image/jpeg" | "image/png" | "image/webp" | "application/pdf"

Response · 201

datarequired: SupportTicketDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/support/tickets/{id}/messages' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Idempotency-Key: 6c0f1d3e-…' \
  -H 'Content-Type: application/json' \
  -d '{"body":"string","attachments":[]}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "number": 0,
    "ref": "string",
    "subject": "string",
    "category": "how_to",
    "priority": "low",
    "status": "open",
    "requester": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string",
      "role": "string"
    },
    "mine": true,
    "first_response_due_at": "2026-10-06T05:30:00.000Z",
    "first_responded_at": "2026-10-06T05:30:00.000Z",
    "first_response": "met",
    "last_message_at": "2026-10-06T05:30:00.000Z",
    "last_message_by": "member",
    "solved_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "messages": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "author_kind": "member",
        "author_name": "string",
        "mine": true,
        "body": "string",
        "attachments": [
          {
            "key": "string",
            "filename": "string",
            "content_type": "string",
            "size": 0,
            "url": "string"
          }
        ],
        "created_at": "2026-10-06T05:30:00.000Z"
      }
    ]
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/support/tickets/{id}/resolve

Mark a ticket as solved

Access: Signed-in members only (web or Android session) — not for API keys.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: SupportTicketDetail
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/support/tickets/{id}/resolve' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "number": 0,
    "ref": "string",
    "subject": "string",
    "category": "how_to",
    "priority": "low",
    "status": "open",
    "requester": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "name": "string",
      "role": "string"
    },
    "mine": true,
    "first_response_due_at": "2026-10-06T05:30:00.000Z",
    "first_responded_at": "2026-10-06T05:30:00.000Z",
    "first_response": "met",
    "last_message_at": "2026-10-06T05:30:00.000Z",
    "last_message_by": "member",
    "solved_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "messages": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "author_kind": "member",
        "author_name": "string",
        "mine": true,
        "body": "string",
        "attachments": [
          {
            "key": "string",
            "filename": "string",
            "content_type": "string",
            "size": 0,
            "url": "string"
          }
        ],
        "created_at": "2026-10-06T05:30:00.000Z"
      }
    ]
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/support/uploads

Upload URL for a ticket attachment

A presigned PUT for one screenshot or PDF (up to 10 MB); pass the key with the ticket or reply.

Access: Signed-in members only (web or Android session) — not for API keys.

Request body

filenamerequired: string
content_typerequired: "image/jpeg" | "image/png" | "image/webp" | "application/pdf"
sizerequired: integer

Response · 200

datarequired: SupportUpload
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/support/uploads' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"string","content_type":"image/jpeg","size":0}'

Response example

{
  "data": {
    "key": "string",
    "url": "string",
    "method": "PUT",
    "headers": {},
    "expires_at": "2026-10-06T05:30:00.000Z"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

{ "data": [ { "id": "cmusrceel0000q7kaafxqi1om", "number": 0, "ref": "string", "subject": "string", "category": "how_to", "priority": "low", "status": "open", "requester": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string", "role": "string" }, "mine": true, "first_response_due_at": "2026-10-06T05:30:00.000Z", "first_responded_at": "2026-10-06T05:30:00.000Z", "first_response": "met", "last_message_at": "2026-10-06T05:30:00.000Z", "last_message_by": "member", "solved_at": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z" } ], "meta": { "next_cursor": "string", "has_more": true } }

curl -X POST 'https://api.propzolo.com/v1/support/tickets' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Idempotency-Key: 6c0f1d3e-…' \ -H 'Content-Type: application/json' \ -d '{"subject":"string","body":"string","category":"how_to","priority":"low","attachments":[],"context":{"path":"string","app_version":"string","user_agent":"string"}}'

{ "data": { "id": "cmusrceel0000q7kaafxqi1om", "number": 0, "ref": "string", "subject": "string", "category": "how_to", "priority": "low", "status": "open", "requester": { "id": "cmusrceel0000q7kaafxqi1om", "name": "string", "role": "string" }, "mine": true, "first_response_due_at": "2026-10-06T05:30:00.000Z", "first_responded_at": "2026-10-06T05:30:00.000Z", "first_response": "met", "last_message_at": "2026-10-06T05:30:00.000Z", "last_message_by": "member", "solved_at": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z", "messages": [ { "id": "cmusrceel0000q7kaafxqi1om", "author_kind": "member", "author_name": "string", "mine": true, "body": "string", "attachments": [ { "key": "string", "filename": "string", "content_type": "string", "size": 0, "url": "string" } ], "created_at": "2026-10-06T05:30:00.000Z" } ] }, "meta": {} }

curl -X POST 'https://api.propzolo.com/v1/support/tickets/{id}/messages' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Idempotency-Key: 6c0f1d3e-…' \ -H 'Content-Type: application/json' \ -d '{"body":"string","attachments":[]}'

curl -X POST 'https://api.propzolo.com/v1/support/uploads' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Content-Type: application/json' \ -d '{"filename":"string","content_type":"image/jpeg","size":0}'