# Create workspace rate

Create a new rate in the workspace

Endpoint: POST /rates
Version: 1.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `name` (string)
    Rate name
    Example: "Director of Photography"

  - `emoji` (string)
    Rate emoji or icon
    Example: "👨‍💻"

  - `description` (string)
    Rate description
    Example: "Cinematography and camera operation"

  - `note` (string)
    Additional notes
    Example: "Includes equipment setup and operation"

  - `quantity` (number)
    Rate quantity
    Example: 40

  - `rate` (number)
    Rate or cost
    Example: 175

  - `unit` (string)
    Unit of measurement
    Enum: "hour", "day", "week", "month", "year", "each", "sqft", "sqm", "lnft", "lnm"

  - `multiplier` (number)
    Rate multiplier
    Example: 1.5

  - `contactId` (string)
    Associated contact ID
    Example: "contact-dp-001"

## Response 201 fields (application/json):

  - `id` (string, required)
    Unique item identifier
    Example: "item-001"

  - `name` (string,null)
    Item display name
    Example: "Director of Photography"

  - `emoji` (string,null)
    Item emoji or icon
    Example: "👨‍💻"

  - `description` (string,null)
    Item description
    Example: "Cinematography and camera operation"

  - `note` (string,null)
    Additional notes about the item
    Example: "Includes equipment setup and operation"

  - `quantity` (number,null)
    Item quantity
    Example: 40

  - `rate` (number,null)
    Item rate or cost per unit
    Example: 175

  - `unit` (string,null)
    Unit of measurement
    Enum: "hour", "day", "week", "month", "year", "each", "sqft", "sqm", "lnft", "lnm"

  - `multiplier` (number,null)
    Rate multiplier
    Example: 1.5

  - `contactId` (string,null)
    Associated contact ID
    Example: "contact-dp-001"

  - `contact` (object)

  - `contact.id` (string, required)
    Contact identifier
    Example: "contact-studio-001"

  - `contact.contactTitle` (string,null)
    Contact display title
    Example: "Sunset Studios - Production Company"

  - `contact.name` (string,null)
    Contact name
    Example: "Alex Rivera"

  - `contact.email` (string,null)
    Contact email address
    Example: "alex.rivera@sunsetstudios.com"

  - `contact.company` (string,null)
    Contact company
    Example: "Sunset Studios Inc."

  - `contact.type` (string,null)
    Contact type (Person, Company, etc.)
    Example: "Person"

  - `contact.jobTitle` (string,null)
    Contact job title
    Example: "Director of Photography"

  - `contact.rate` (number,null)
    Contact hourly rate
    Example: 150

  - `contact.secureInfo` (object)

  - `contact.secureInfo.address` (string,null)
    Contact address
    Example: "123 Sunset Blvd, Los Angeles, CA 90028"

  - `contact.secureInfo.phone` (string,null)
    Contact phone number
    Example: "310-555-1234"

  - `contact.secureInfo.taxIdLast4` (string,null)
    Last 4 digits of tax ID
    Example: "4567"

  - `contact.origin` (object)

  - `contact.origin.origin` (string,null)
    How the contact was created
    Enum: "onboarding", "manual"

  - `contact.origin.createdAt` (string,null)
    Contact creation timestamp
    Example: "2024-02-15T08:00:00Z"

  - `contact.origin.createdByUser` (object)

  - `contact.origin.createdByUser.id` (string, required)
    User identifier
    Example: "user-001"

  - `contact.origin.createdByUser.name` (string, required)
    User name
    Example: "Sarah Chen"

  - `contact.origin.createdByUser.email` (string, required)
    User email address
    Example: "sarah.chen@sunsetstudios.com"

  - `contact.startwork` (array)
    Startwork agreements

  - `contact.startwork.id` (string, required)
    Startwork agreement identifier
    Example: "startwork-001"

  - `contact.startwork.title` (string, required)
    Agreement title
    Example: "Independent Contractor Agreement"

  - `contact.startwork.signedOn` (string, required)
    Signature timestamp
    Example: "2024-03-01T10:00:00Z"

  - `contact.linkedUser` (object)

  - `contact.bankInfo` (array)
    Banking information

  - `contact.bankInfo.id` (string, required)
    Bank account identifier
    Example: "bank-acc-001"

  - `contact.bankInfo.bankName` (string, required)
    Bank name
    Example: "Chase Bank"

  - `contact.bankInfo.accountType` (string, required)
    Account type (checking, savings, etc.)
    Example: "checking"

  - `contact.bankInfo.accountLast4` (string, required)
    Last 4 digits of account number
    Example: "4567"

  - `contact.taxDocuments` (array)
    Tax documents

  - `contact.taxDocuments.id` (string, required)
    File identifier (DigitalOcean Spaces object key)
    Example: "files/2024/03/budget-report.pdf"

  - `contact.taxDocuments.name` (string, required)
    Original filename
    Example: "call-sheet-day-3.pdf"

  - `contact.taxDocuments.type` (string, required)
    MIME type
    Example: "application/pdf"

  - `contact.taxDocuments.size` (integer, required)
    File size in bytes
    Example: 1048576

  - `contact.attachments` (array)
    File attachments

  - `contact.projects` (object)
    Associated projects

## Response 400 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"

## Response 404 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"