---
title: "Create Request"
method: POST
path: "/v2/customer_portal/request"
---

# Create Request

`POST /v2/customer_portal/request`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/v2/customer_portal/request`
- Auth: HTTP bearer

This endpoint belongs to the separate Customer Portal service (the end-customer self-service portal), not the main company API. It requires a Customer Portal session bearer token, obtained when an end customer logs into their own portal — your company x-api-key will not work here and will return 401 "Unauthenticated Request". If you're building a company-side integration, use the company API's own Create/Get Request endpoints instead (see "Create Request" and "Get Request Details" under the main Requests section, which do accept x-api-key).

## Request body

- object
  - `request` object
    - `request_title` string
    - `request_description` string
    - `service_contract` string
    - `property_uid` string
    - `asset_uid` string
    - `request_service` string
    - `attachments` object[]
      - `file_name` string, required
      - `url` string, required
      - `file_size` integer
      - `visible_to_customer` boolean
    - `service_address` object
      - `city` string
      - `state` string
      - `street` string
      - `country` string
      - `landmark` string
      - `zip_code` string
      - `geo_cordinates` number[]
      - `first_name` string
      - `last_name` string
      - `phone_number` string: Customer phone number
      - `email` string: Customer email
      - `label` string: Label
    - `billing_address` object
      - `city` string
      - `state` string
      - `street` string
      - `country` string
      - `landmark` string
      - `zip_code` string
      - `geo_cordinates` number[]
      - `first_name` string
      - `last_name` string
      - `phone_number` string: Customer phone number
      - `email` string: Customer email
      - `label` string: Label
    - `custom_fields` object[]
      - `label` string, required
      - `value` string, required
      - `type` string, required
      - `ref_uid` string
      - `module_name` 'JOB' | 'CUSTOMER' | 'EMPLOYEE' | 'ESTIMATE' | 'INVOICE' | 'PRODUCT' | 'PURCHASE_ORDER' | 'SERVICE_CONTRACT' | 'ASSET' | 'PROPERTY' | 'ORGANIZATION' | 'TEAM' | 'REQUEST' | 'PROJECT'
      - `hide_to_fe` boolean
      - `hide_field` boolean
      - `read_only` boolean
      - `group_name` string
      - `group_uid` string
    - `request_preferred_date1` object
      - `start_time` string, date
      - `end_time` string, date
    - `request_preferred_date2` object
      - `start_time` string, date
      - object
        - `end_time` string, date

## Response `200`

200

- object
  - `type` string
  - `data` object
    - `request_uid` string

## Other responses

- `404`: 404

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/v2/customer_portal/request/post.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)